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WELCOME TO 
GET STARTED 
WITH RASPBERRY PI 


ou are holding, in your hands, a piece of history. 
This isn’t just a book about a computer: It’s a book 
with a computer. 

Not just any computer either. Raspberry Pi 3A+ is an 
incredibly well-designed microcomputer. And it’s part of 
the most creative computer family on Earth. 

With a Raspberry Pi, you can hack, make and build all 
kinds of different things. It could be a digital camera, ora 
retro games console, or a home media centre. Or a Sensor on 
board the International Space Station, or a programmable 
Minecraft machine. 

Almost everything you need to get started with a 
Raspberry Pi computer is inside this kit, including a 
memory card for the operating system and storage. All you 
need to add is a USB keyboard and mouse, HDMI cable, and 
5V micro USB power supply (such as a phone charger). 

Our tutorials will guide you, step-by-step, from setting 
up Raspberry Pi 3A+ hardware to learning how to use the 
Raspbian operating system, through to hacking electronics 
with the GPIO pins on your Raspberry Pi 3A+. 

You’ ll also learn how to program a computer with Scratch 
and Python, two of the world’s best programming languages. 

We’re so glad you’ve got Get Started with Raspberry Pi 
with the Official Starter Kit. Now let’s begin... 
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Learn about Raspberry Pi 3A+ 
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What's required to get up and running 
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Put it in its case and get it connected 


12 INSTALLING RASPBIAN 
Use your memory card to install the OS 
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Start programming with Scratch and Python 
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Set up and use a Raspberry Pi camera 
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Receive radio signals from the ISS 
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Master Raspberry Pi with these tricks 


88 BUILD A SAMBA FILE SERVER 
Share your files with other computers 


92 USE SSH 
Remotely control your Raspberry Pi 
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Discover the power of terminal commands 
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The microSD card in your kit acts as the hard drive 
for your Raspberry Pi. After removing it from the SD 
adaptor, you install the Raspbian operating system 
onto the card, then all your documents, files, and 
projects are saved to it as you work. The microSD 
card in your Starter Kit is a high-quality piece 

of equipment and comes with NOOBS pre-installed. 

If you want to use a larger capacity card, take a look at 
the results from benchmark tests done by Raspberry Pi 
fan Jeff Geerling. Some cards run up to four times as fast 
as others. You can read more at magpi.cc/xZLRky. 
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The official operating system is the 
easiest to use, and the one beginners 
should start with. It works a lot like 
other popular operating systems. 








Not the full version of Windows, 

but Windows 10 lol Core enables 
programmers to run Internet of 
Things and embedded projects. 
TS 
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Ubuntu is one of the world’s most 

popular Linux operating systems, and 
Ubuntu MATE is a lightweight version 
that runs just fine on the Raspberry Pi. 
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Raspberry Pi Configuration 


Need to adjust some settings? The 
Raspberry Pi Configuration tool is 
in the Preferences section of the 
applications menu. In its System tab, 
you can change your password, adjust 
display options, and set Raspberry 
Pi to boot to the command-line 
interface (CLI) instead of the desktop. 
In the Interfaces tab, you can 
enable connections, including 
remote GPIO access and the camera. 


To adjust the amount of memory for 
the GPU or to set older Raspberry Pi 
models to run faster (overclocking), 
visit the Performance tab. 
You can change the time zone, 
keyboard, and other geographic 
(o} 0) Koy aksweh one bY =a Borer- 1 bicy- m0) elm r- 10 
There are separate options in 
Preferences for configuring the 
appearance, audio, main menu, 
mouse and keyboard, and screen. 
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Discover some of the software 
that comes with Raspbian, and 
find out how to install more 


aspbian comes with a selection of pre- 
installed software (which depends on 
which version you install), so you can start 
working, learning, and making things straight 
away. Ranging from productivity suites to games, 
you’ ll find a well-curated collection of software is 
just a click away, in the applications menu. There 
are lots more packages to browse and install, too. 





R 


t LibreOffice Writer | OFFICE 
=| Nocomputer is complete without a word 
| processor. LibreOffice Writer has all the 
font and formatting options you would expect, and 
has basic compatibility with Microsoft Word. 


SN LibreOffice Calc | OFFICE 
Work out your budgets with this 
— spreadsheet package. If you’re familiar 
with Microsoft Excel, you’ ll feel at home here. 


LibreOffice Calc can open and use typical Excel files. 





NS LibreOffice Impress | OFFICE 

| If you’re presenting to a room of people, 
don’t panic: Impress has your back. Use 
it to craft and display your slide deck. It’s largely 
compatible with Microsoft PowerPoint. 


= Chromium | INTERNET 
Chromium is the open-source version 
of Google Chrome. The default search 
engine in Raspbian is Duck Duck Go, which 
promises not to track you online. 


Claws Mail | INTERNET 

Send and receive email. The setup wizard 
helps you add your email account, and the 

streamlined interface shows you your mailboxes, 

message list, and a preview of the selected message. 





LL 


™ VLC | SOUND & VIDEO 
Listen to music while you’re coding using 
VLC, a fully featured media player for 
music and video. It can play digital files, streams, 
and physical media such as CDs and DVDs. 


Minecraft Pi | GAMES 

We call it a game, but it’s more a way 

; of life. With Minecraft Pi, you can build 
things in Creative mode, and write programs to 
change the (game) world. 





Python Games | GAMES 

These tea-break games are fun, but 
they’re also great Python demos. Find the 
code in the /usr/share/python_games folder, and 
open it ina Python editor to see how it works. 


SmartSim | PROGRAMMING 
Experiment with designing and testing 

digital logic circuits. You can develop 
custom components and then incorporate them 


into other circuits. Download examples and read 
tutorials at smartsim.org.uk. 


“s. Sense HAT Emulator 
PROGRAMMING 

This emulator features on-screen 
controls to simulate temperature, pressure, 


humidity, and device position changes. A great way 
to try out the Sense HAT before you buy one! 





Updating your software 


Linux software comes in packages, 
which are compressed archives 
that you can download. A package 
manager is used to find and install 
them, including any other software 
they need to work. 
Use Add/Remove Software to 
update your packages. From the 
menu, choose Preferences > Add / Remove Software. Click on 
Options and Check for Updates. 
You can also update from Terminal. In Raspbian, the package 
manager is called APT. Updating all the software from the Terminal 


A (Ohi) OM LC KMSUdO apt-get updatepbammats 


Terminal to update the cache of available software. Then enter 

to update the software installed on Raspberry 
Pi. You’1l be told what changes will be made and asked to confirm by 
typing Y and pressing ENTER. 


Installing software 


The easiest way to manage software is to use the Add / Remove 
Software tool in the Preferences part of the applications menu. It 
provides a visual front-end for the package manager. 

You can click a category on the left to browse applications, or 
enter a keyword in the search box in the top-left to look for a 
particular application. Choose the applications you want to install 
by ticking the box beside them. Some packages require other 
packages to work properly, but the tool will take care of that for 
you. To remove an application, untick its box. When you’ve made 
your choices, click OK to install or remove your software. 
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connect to your Raspberry Pi from another 

device: Secure Shell (SSH) and Virtual 
Network Computing (VNC). Before you can use 
them, they need to be switched on in the Raspberry 
Pi Configuration settings. To do so, click the 
Interfaces tab, then enable SSH and/or VNC. 

Both approaches require you to know the IP 
address of your Raspberry Pi. The easiest way to find 
it is to hover the mouse pointer over the WiFi icon 
in the taskbar. Alternatively, click the Terminal icon 
and enter ifconfig. It will show you all your network 
connections. You’re looking for an IP address, which 
will be four numbers with a dot between them, 
like 198.51.100.0. You’ ll find it beside ‘inet’, in the 
details for wlano if you’re using WiFi or in the etho 
summary if you’re plugged in to the network. 


T here are two technologies you can use to 


Using SSH 

SSH enables you to use the command line on 

your Raspberry Pi remotely, so it’s very handy for 
installing software and fixing configuration files. 
You can’t use SSH to run any applications that need 
the graphical desktop, though. 





























| Raspberry Pi Configuration oa 
system Interfaces | Performance | Localisation 
Camera Enabled * Disabled 
SoH * Enabled Disabled 
VNC * Enabled Disabled 
SPI Enabled * Disabled 
2c Enabled * Disabled 
Serial Port Enabled e Disabled 
Serial Console 
1-Wire Enabled * Disabled 
Remote GPIO Enabled ® Disabled 
Cancel OK 


A Enable SSH and VNC before you try to use them 


lf your Raspberry Pi is up in g tree photographing nature, you don't 
want to climb up there just to update It. Log in remotely and take control 


The software for SSH is pre-installed on 
Linux, macOS, and Windows 10. Start by opening 
the command line. On a Mac, find it by typing 
‘Terminal’ into the Spotlight search. On Windows 
10, Use @+R to open the Run dialog box, then 
type in cmd. 

Once you’re in the command line, enter 
ssh pi@198.51.100.0, but replace the numbers 
with the IP address of your own Raspberry Pi 
device. The ‘pi’ bit is your username. 


M SSH enables you to use 
the command line on your 
Raspberry Pi remotely, so 
it's very handy @ 


The first time you connect to a device using SSH, 
you’ ll see a warning that shows the ECDSA key 
for the device you’re trying to connect to. You can 
(if you wish) validate that this is correct by using 
ssh-keygen -l -f /etc/ssh/ssh_host_ecdsa_key.pub 
in the Raspberry Pi Terminal. But it’s usually OK to 
just type in yes and then press ENTER to confirm 
you want to connect. 

You’ ll be asked to enter the password for your 
Raspberry Pi device. You won’t see the cursor move 
while you do this, so type on regardless. When you 
press ENTER, you’re in! You’ll see a Linux welcome 
message, the date and time of your last login, and 
then the Raspbian command prompt, waiting for 
instructions. When you’ve finished, enter exit to 
leave the SSH session. 

If you’re using an earlier version of Windows, 
download PuTTY from putty.org. Enter your 
Raspberry Pi’s IP address in the Host Name box, and 
click Open. Again, you’ ll see a warning if this is your 
first connection, which you can safely dismiss. Log 
in as pi, and enter your password. Raspberry Pi is 
now at your command! 





A Using VNC Viewer to manage Raspberry Pi from an iPad 


Using VNC 

Virtual Network Computing (VNC) enables you to 
remotely access the Raspberry Pi desktop, so you 
can manage files and run software using it. Some 
people use VNC to share their keyboard, mouse, and 
monitor between a PC and Raspberry Pi. 

Raspbian includes VNC Server, which runs 
automatically in the background if you’ve enabled it 
in your settings. You’1l need to download and install 
VNC Viewer (magpi.cc/FuGnye) on the device you 
want to use to control Raspberry Pi. VNC Viewer is 
available for Windows, macOS, and Linux. There are 
also Android and iOS apps, so you can use VNC to 
control Raspberry Pi from a mobile device, although 
it’s rather fiddly without a real mouse and keyboard. 
Optionally, by creating a RealVNC account and 
registering your Raspberry Pi, you can then access it 
from anywhere in the world using VNC Viewer. 

When you start VNC Viewer, it’1] ask you to enter 
a VNC Server address. This is the IP address you 
noted when you ran ifconfig on your Raspberry Pi. 

The first time you connect to a device, VNC 
Viewer warns you that it has no record of 
connecting to this device before, and shows you the 
device’s signature and identification catchphrase. 
To verify you’re connecting to the correct device, 
click the VNC icon on the right of the taskbar in 
Raspbian to see your device’s details. 

VNC Viewer prompts you to enter the username 
and password for the device you’re connecting to. 
You’ ll then see your Raspbian desktop in the VNC 
Viewer window. You can now use your keyboard 
and mouse (or touchscreen on a mobile device) 
to control the Raspbian desktop, including using 
programs installed on Raspberry Pi. 


VNC Viewer - File Transfer 
To send files te VNC Server, click the Send files button, below. 
Te feteh files from VAC Server, nanagete to the VNC Server igen in the nothicahon tray or 
status bar and select File Transfer from its shortcut menu. 
Te change where files fetched te this computer are saved, use the Fetch files to drop-down 
list, below. 


[Send es Ftc iso: Desktop 


At the top of VNC Viewer in the middle is a tiny 
toolbar. The File Transfer option enables you to easily 
copy files to Raspberry Pi. 
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Send files from Raspberry Pi using the File Transfer 
option in VNC Server in Raspbian. Use the three-bars 
menu (top-right) to find it. 


Tools 

Wed 10 Jul 2019 14:43 

pi: Hi there! Who's connected right now? 
pi (Local): just me, buddy 

Wed 10 Jul 2019 14:44 

pi: Did you manage to fix that bug? 

pi (Local): yes and no 

Wed 10 Jul 2019 14:45 

pi: what does that mean? 


pi (Local): well, | fixed the bug just fine. But the fix caused 
another one. So I'm trying to sort that out now. 


Wed 10 Jul 2019 14:49 
pi: hello 
Wed 10 Jul 2019 14:51 


pl: who just joined? 


Use the toolbar in VNC Viewer to start a chat 
session with anyone using the server (Raspberry Pi 
device) and anyone else connected to it remotely. 
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Tip! 


Raspberry Pi comes with everything 
you need to start programming 


in for a treat. Raspbian comes with several 

integrated development environments (IDEs) 
you can use to write your own programs, supporting 
languages that are friendly to use, and fun to tinker 
with. If you’re a veteran coder, you’ ll find powerful 
IDEs are included to help you be productive, too. 


f you’ve never programmed before, you’re 


Scratch 2 

LANGUAGE: SCRATCH 

With its friendly drag-and-drop commands and 

a library of sprites and sound effects, Scratch 
makes it simple to get started with coding. By 
minimising typing, and guiding you to sensible 
block combinations, it helps you to avoid common 
mistakes. Don’t be fooled by its accessibility, 
though: it’s a fully-fledged programming 
language, with plenty of potential. 


Thonny 

LANGUAGE: PYTHON 

Python is one of the most popular languages on 
Raspberry Pi, and Thonny is our favourite way to 
edit it. Ina single window it shows you your code, 
the shell, and your data (variables), so you can easily 
see what’s going on and fix any bugs that creep in. 


























Sonic Pi SS ee 
tancuace: SONIC PI = 
Learn how to 
compose and perform 
music with code! 
Sonic Pi incorporates 
synths, samples, and 
effects that you can 
control by writing programs using a language based 
on Ruby. You can develop and modify programs 
while the music plays, to perform live concerts or 
improvise at home. 


Sa. 





Node-RED 

tancuace: JAVASCRIPT/NODE-RED 

Node-RED enables you to use a flowchart to program 
data flows for Internet of Things applications on 
Raspberry Pi. It uses JavaScript, the language of the 
web. Run the Node-RED console in Raspbian and 
then visit http://localhost:1880 in your browser to 
program it. For help, see nodered.org. 


Greenfoot 
LANGUAGE: JAVA 

Java is one of the 
world’s most popular 
programming 
languages. Greenfoot 
makes it easier to 
learn, by providing a friendly environment for 
building simple games. The editor incorporates 

a game world, and you add Java code to image 
objects to control their interactions. Find out more 
at greenfoot.org. 





Geany 

LANGUAGE: LUIS! 

If you’re looking for a lightweight but powerful 
IDE, try Geany. It supports many languages, 
including HTML, C, Java, PHP, JavaScript, and Perl. 
Its code auto-completion and syntax highlighting 
can help you code faster, and reduce errors. Our 
favourite feature® Code folding, used to show or 
hide logical chunks of code in a long program. 


The Official Raspberry 

Pi Beginner's Guide 

Available to buy in print and as a free PDF, 
this book shows you how to set up Raspberry 
Pi, and gets you started with programming 
it in Scratch and Python. It also covers the 
Sense HAT and Raspberry Pi Camera Module, 
with code examples you can build and tailor. 


magpi.cc/BGbook 


GPIO Zero Documentation 

See how easy it is to start programming your 
own electronics projects for Raspberry Pi. 
The documentation for GPIO Zero shows you 
how to connect up sensors, LEDs, motors, 
and more. With a bag of cheap components, 
you can start building your first circuits. 


rpf.io/gpiozero 


Hacking and 

Making in Minecraft 

Minecraft on Raspberry Piisa 
great way into the world of coding. 
This book, another in The MagPi 
Essentials series, shows you how to 
shape the world with Python code, 
use a connected LED as a treasure 
sensor, and use Sonic Pi and Node- 
RED together with Minecraft. 


magpi.cc/MCbook 
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Official Raspberry Pi 

Documentation 

The documentation provides concise user 
guides for Linux, Minecraft, Sonic Pi, Scratch, 
and Python. It’s also the place to go for 
advice on configuring Raspberry Pi, hardware 
specifications, and remote access tips. Useful 
for both beginners and power users. 


rpf.io/docs 


Conquer the Command Line 

We publish a series of short books called The 
MagPi Essentials, and this one explains the meer 
Terminal, including using it for connecting \: COMIN AAND 
disks, compiling software, and backing up. You [ HAIN 
can download all the books in the series, and 
past issues of The MagPi, at magpi.cc/issues. 





> Vile fhaspberry Pi 


magpi.cc/CLibook 





Python Games 

Go behind the scenes of the Python games that 
come pre-installed in Raspbian with Al Sweigart’s 
free online book. It explains the program code for 
seven of the games in detail, and lets you study 
another four listings yourself. 


magpi.cc/RTfkvD 
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skills you will ever develop. With code, you can 


mi ) p30 MAKE AN 
EB MOG lst 
| earning to code can be one of the most profound Eee ae ley 


control a computer. You can get it to do things for you, 
and also control gizmos and other computers. Kick back and 






let your computer do all the work. 


Sure, that’s cool. But coding is about more than that. It’s 


about understanding how computers work, and getting a erin 
better understanding of how technology - and the modern 


world — works. It’s about breaking down problems into little 
bits and solving them. It’s an amazingly helpful life skill. 


That’s why it’s profound. 


On a more practical level, knowing just a little code can 
lead to better job opportunities; a little more can open up 
well-paid and fun jobs. It’s an impressive skill to put on 
your CV and anybody can do it. Anybody. 
Coding is a lot easier than you think. And putting the 
power of computing and digital making into the hands of 
people is what Raspberry Pi is all about. 
Raspberry Pi is ‘the little computer that could’, and 
you’re ‘the person who can’. Don’t worry: you’ve got 
this. We can help you get started. 






M Raspberry PI Is ‘the little 





@e)aaelelasjanaplelanqeleliemme|alem’ic|eha- 
‘the person who can’ 
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Beginners, arise! It's time to take your first steps with 
coding, ds we introduce you to Scratch and Python, with 
g sprinkling of twinkling LEDs! By Sean McManus 


eing able to write programs is like a superpower: 
it Means you can get your computer to do 
whatever you want. Join us as we show you 
how to make your first programs using Scratch and 
Python. You’ll also see how easy it is to build simple 
) K-Yel we) oN Lensws 9) 0) [=e] BSE 
A program is just a set of instructions. In Scratch, 
the instructions are written with visual blocks that 
lock together to make a sequence called a script. 
The blocks are colour-coded to help you find 
id al=) on bam Komen boXe Ine ol<Mp)xe)'\sn lp) Kolel «pun Ke) mi=>:¢-0 0098) (oF 
click the brown Events button above the 
Blocks Palette. 
Scratch makes coding easier, because you 
don’t need to worry about the spelling of 
(oo) nabask-balehcpu-Uelem-arccomvamabbercaicmr-blemelenannel 
front of you. 













The Scratch screen is divided into units called 
steps. When the cat moves 10 steps, it only makes 
one movement, but that stride shifts it 10 positions 
across the Stage. The middle of the Stage is at 
x=0, y=0. The x-axis (left to right) runs from -240 
to +240, and the y-axis (bottom to top) runs from 
-180 to +180. The directions the sprite can move 
in are numbered 0 (up), 90 (right), 180 or -180 
(down), and -90 (left). You can use numbers in 
between those numbers too, so -45 would be a 


01 Start Scratch 2 
Open Scratch by clicking on the Raspberry Pi 
Menu icon and choosing Programming > Scratch 2. 
You will see Scratch interface and a single 
character in the top-left, known as ‘Scratch Cat’. 

To control the Scratch Cat, we’re going to drag 
blocks from the Blocks Palette into the Scripts Area 
and join them together. 

Start by clicking on Events and drag the 
when __ clicked block to the Scripts Area. 

INKo)iatel bel ete) oY Kohno) ale-baXe mebw-toare! 
point in direction 90 block and connect it the to 
the bottom of the (when __ clicked) block. 

Click on the fields in the blocks to edit the 
numbers. Click on ‘90’ and change it to ‘o’. 

INCo) i aed bel <@r-b ae eb r= team al=m 0) (olel ccm o\-) Koyvaur- bale m=ren ne 
their numbers, to build a script for Scratch Cat. 
This script runs when you click the green flag 
above the Stage. It sets the cat’s movement 
direction to up, puts the cat in the top-left corner 
of the Stage, and sets it to always face left or right. 
Then, the movement blocks inside the (forever 
bracket keep the cat moving all the time. 

Click the green flag to run your script. Scratch 
Cat will move to the left side and bounce up 
and down. 


clicked 


north-west direction. Why not try starting a new 
project and joining some Motion blocks together 
to experiment? You can run a script or a block by 
clicking it, or use the when flag clicked block as 
we did in our program here. 


forever 








in a hs eg Lt“ 


a / ae 


02 Send a broadcast 

The moving objects in Scratch, including 
the cat, are called sprites. One sprite can senda 
message to all the other sprites using a broadcast. 
You can’t hear it or see it on screen, but sprites 
can listen for it, and then start a script when they 
receive it. We’ll use a broadcast to make the cat 
throw some bananas. Click the brown Events 
button, and add the two blocks below to the Scripts 
Area. This new script doesn’t join to the existing 
script (from Step 1) - it sits on its own in the same 
Scripts Area. 

You need to change ‘message1’ to ‘fire’. Click 
the down arrow next to ‘message1’ in the broadcast 
block and choose New Message. Enter the message 
name ‘fire’ and click OK. 

As the program is running, when you tap SPACE, 
the broadcast message is sent silently. Crafty! 


when space key pressed 


broadcast fire 





03 Add aerodynamic bananas 

Scratch enables you to get results fast 
because it includes its own images and sounds. 
Click the first New Sprite button above the Sprite 
List (it will display ‘Choose sprite from library’ as 
you hover over it). 

















Blocks Palette: Find 
Nalsiaauleas(e)am e)lelei.<sm als)a>) 


Tol d/o) -9-\c-1- Ha) eo lemelale| 
(o| xe) o)Korei com al-1g-mcon olel ice! 
Wielulmsvoial elm e)cele|e-laa)) 


= TUL a Ke) a \-H @lN(@1 KO MVAI)( 
ollinciaclal MAY Lose) OlKolel.<oula 
the Blocks Palette below 


Sprite List: Select and 
Iaatelate(eloms) OgiKosom alo a> 


Click the Bananas sprite to add it to the Sprite 
List. Notice that its Scripts Area is blank. We’ll 
give Bananas two scripts. The first one sets the 
Sprite’s size and makes it invisible when you click 
the green flag. The second runs when the cat 
broadcasts its fire message. Click and drag the 
blocks below to the Scripts Area. 


Top Tip 


Get the 
right sprite 


Make sure you're 
Xoo lial msxolg |e) Kako) 
ial-mexe) dc-Yoim-jelgi key 
You can select a 
Jo) dikom oN Vmerilel dare) 


clicked it in the Sprite List. 


When adding the 19) KoXel euch n-temaal= 
block inside the round ‘y:’ field to 
replace the ‘10’ default value. 

The ‘fire’ broadcast makes the bananas jump 
to the cat (use the go to mouse- pointer block, 
and choose Cat1 in its menu). Then it makes the 
bananas visible, glides them across the screen, and 
hides them again. 

Click the green flag, and tap SPACE to test. 
Scratch Cat now throws bananas. 
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Top Tip 


3} (elem labsiie(= 
blocks 


Yo) ga l= 0) Ketel <omerel a 
fofomlarsire(ome)sal-16 
19) KoXei mm labs) k=) OC y 
the y position 

|e] KoXel a <-1=) osm al— 
sprite’s y position 
imalomst-laal=mvaaliks 
its x position 

folate laletossy 









clicked 


when 





cet score to 0) 





04 Add monkey magic 

Variables are names used to remember 
information, such as a score, that might change. 
Click the Data button and click Make a Variable. 
Give it the name ‘score’, select For All Sprites, and 
click OK. Let’s add a moving target for the cat to try 
to hit. Click the ‘Choose sprite from library’ icon 
and choose the Monkeyz2. Select Monkey2 in the 
Sprites area and give it the script above. 

The monkey’s script sets the new score variable 
to o when the game Starts, then makes the monkey 
move up and down. Each sprite can have more 

than one image: the Next Costume block cycles 

id eb me)btcd elma al-)a0hmenncr-lanetcar-Daur-benbest-laleyen 


05 Add collision detection 
Our monkey will react when it’s 
struck by a bunch of bananas. To do that, 
we use an {if block; this checks whether 










We're huge fans of Scratch at The MagPi, so 
check out our past issues online for more Scratch 
tutorials. Issue 5 includes a memory game, like 
Simple Brian. Issue 34 has a multiple-choice quiz, 
and our 2018 Annual included an introduction 


to electronics and Scratch. See issue 76 for 
a roundup of resources to help you learn 
Scratch, and don't forget there's a Scratch book 
in The MagPi's own Essentials series 
(magpi.cc/learnscratch) and the Code Club Book 
of Scratch (magpi.cc/ccbookz). 


change score 


wart ey Secs 





something is true — in this case, whether the 
monkey is touching the bananas. If so, the blocks 
inside its bracket are run. Here, those blocks 
hide the monkey, add 1 to the score, and wait one 
second before showing the monkey again. 

This whole code chunk goes inside the monkey’s 
forever) bracket — below the next costume 10) KoYed << 
— so the program keeps checking whether the 
monkey has been hit. 


06 Finishing touches 

Let’s add a simple timer to stop the sprites 
moving after 30 seconds, and make the monkey 
react when it sees incoming bananas. Add these 
two scripts to the monkey sprite. Now the game is 
complete, why not try experimenting with it? Can 
you make the monkey move erratically instead of 
disappearing when it’s hit? Can you change the 
sprites’ positions and directions to turn the game 
sideways, making it more like Space Invaders? 
What about adding more targets to hit? One of the 
best ways to learn to code is by experimenting with 
existing programs. 


FEATURE 





Code a quiz game 


Make your own text quiz game that mangles famous 
ohrases using the Python language 


any people progress from Scratch Thonny - ¢home/pi/190417 only connect py @ 39:47 =u 
to Python, a programming language -“-ouyOh i & ‘= = 
that is powerful, easy to get started New Load Run Debug =P 
with, and much easier to read and write than 190417 only connect py * 
other languages. import, randos 
We’re going to make a simple quiz question questions = (“As you like it", “The Tempest", “Measure for Measure”, 


"Such Ado About Nothing". “The Comedy of Errors", 
generator that strips the vowels and shuffles the (01) ‘King Lear", “Cymbeline", "Hamlet", "Coriolanus", “Othello”, 
F "Love's Labour's Lost", “King John", “Julius Caesar", d 
Spaces in a phrase. The player has to work out what 
o chesen phrase = random .choice( questions) 
that phrase 1S. chosen phrase = chosen phrase upper) 

We’ll be using Thonny, which provides a 
friendly single-screen environment for running vowels = ["A", “E®, 
and testing Python code. Like Scratch, the Thonny | 
IDE (integrated development environment) comes 


puzzle = “' 


for Letter in chesen phrase: 


pre-installed in the Raspbian with Desktop and See ae ee 


puzzle += Letter 


Recommended Software operating system. 


a 
Shell 
SL2es F 


hat 1s yOUr Quese? Julius Caegar 
Thak"s correct | 


01 Create a list of questions x 
As well as variables, Python has lists, which ag oA greg ala 


can store multiple pieces of information. Our se | 
program creates a list called questions. Each item 






















in the list is a piece of text, known as a String. In Python, strings are surrounded by double quotes 6p Type in and edit 
to show where they start and end. The whole list is Vent eee) etn 
: code here 
enclosed in square brackets, and there are commas 
between the list items. Type in the code below, save 6m Enter direct 
: : oro) aalaatelarelcmelare| 
your program, and then click Run. If it worked, you see program input 
should see no error messages in the Shell window. in the Shell here 
03 Keep track of the 
, , , import random olleemVelulmelcolelg-lan 
Python uses indentation to show which is processing here 


instructions belong to a function, an if statement, 
or a repeating section. As you can see in Step 3 questions — ["As You Like It", 
(overleaf), you can have multiple levels of "The Tempest", "Measure for Measure", 
indentation. The last line belongs to the if "Much Ado About Nothing", You'll Need 
instruction, and that is repeated inside the for "The Comedy of Errors", 
loop. The best way to get the indentation right is 
to remember the colon at the end of the previous 


Raspbian with 


a Gr a} ode I =Y- | au GA (| 0) = 0 Og (= 
. : 2 ‘ DY=Xs1-4Ko) ome lale| 


aan F-11110 =) Oa GX) an Ko) r- | 010 (©) wd a= Wl Ko 


line. Then, Thonny will add the indentation for you F é corexe)aalaat= are (axe! 
automatically. If you forget, use four spaces at the Love's Labour's Lost”, Software 
start of the line to insert the indentation. You'll still “King Jonh > Julius Caesar, Thonn’ 


need to fix that missing colon, though! ia sXe] axe ee | 
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Where next? 


You can find Python code to dissect in most issues 
of The MagPi. |lssue 53 (magpi.cc/53) includes 
a more in-depth beginner's guide to Python, 
covering variables, looping with while and for, 





Pick a random question 





[sje TI p e Python includes modules of prewritten 
code you can use, such as the random module 

Pesky we imported in Step 1. The first new instruction 
punctuation! creates a new variable called chosen_phrase and 
puts a randomly chosen question into it. The 
second line converts the chosen_phrase to upper 
case. Run the program a few times and look at the 
value of chosen_phrase in the Variables pane. You 
should see different names come up, although 
names can also repeat. 

Add a line of space between the code in Step 1 
and add the following code: 


Take care to 
reYolem dal-mexe) Kolals 
el mdalomvalemeya 
the if and else 
asiqauceid(o)alswm mals) 
code won't work 
Waidalelovmndalclaan 





(ol aoks1=1 0 8) A] r= 1 
(ol aoks1=1 0 8) 0] r= 1 


far] a (e)\/Puelalonmet=d @6[6[-t-nen Ke) al-@) 
chosen_phrase.upper() 
































Strip the vowels and spaces 
Let’s create a new list of forbidden 
characters, chiefly the vowels, but also the 
Space and the apostrophe. That last list item in 
the vowels list is an apostrophe inside double 
quotes. We create an empty string variable, called 
puzzle. We’re going to go through each letter in 
the phrase, check whether it’s in the vowels list, 
and if not, add it to the end of the puzzle string. 
The for instruction sets up a repeating piece 
of code, called a loop. The instructions that 
should be repeated are indented from left. Each 
time around the loop, the variable letter is 
set to contain the next character from the 
chosen_phrase string. The if instruction 
checks whether the letter is in the vowels 


Debugging in Thonny 


You can step through the program slowly to see 
what it's doing, which can help you to find errors. 
Click the Debug button in Thonny, then click the 
Over button to run through each instruction in turn. 
Watch the Variables pane on the right to see how 
the lists and strings change at each stage of the 
program. Thonny also helps you avoid errors by 


highlighting unclosed brackets and double quotes. 


branching with if, and functions, which we'll 
cover shortly in this guide. Issue 54 (magpi.cc/53) 
introduces object-oriented programming in both 
Scratch and Python. Issue 73 (magpi.cc/73) 
includes a roundup of Python books and online 





resources. There is a book in our Essentials 
series too, called Make Games with Python 
(magpi.cc/gameswithpython). 


list. If it is not, the letter is added to the end of 
puzzle. The += means ‘add at the end’. Run the 
program, then test it’s working by looking at the 
contents of puzzle in the Variables panel. It should 
contain no vowels, spaces, or apostrophes. 

Add the following code to the program: 


vowels [ 5) J 5) 5) 5) 5) ] 
puzzle 
letter chosen_phrase: 
letter vowels: 
puzzle letter 


Insert random spaces 

Each character in the string can be referred 
to by its position number, starting at o. The number 
is called an index, and you put it in square brackets 
after the string. Try this in the Shell (click on the 
line starting with ‘>>>’). Instructions in the Shell 
are carried out immediately. Enter the following: 


print( [1]) 


You get ‘e’ back (because the first character is 
number 0). You can get a chunk too (called a slice) 
by giving a start and end index, like this: 


print( [1:4]) 


It gives you ‘ell’ because the last index position 
(4) is left out. We’ll create a new list, called 
puzzle with_spaces, by adding chunks of the 
puzzle string and a space until there’s no puzzle 
string left. The while loop repeats the indented 
instructions below as long as the length of puzzle 
is more than oO. The group_length variable is 
given a random whole number (integer) from 
1 to 5. Then that many letters are added 
to puzzle with spaces from the front of 
puzzle, plus a space. Those characters are 


Python Is easy to get started 
with and much easier to read and 
write than other languages 





then cut off the front of puzzle. The slicing here 
only uses one number, so the other one is assumed 
to be the start or end of the string. 

Add this code to your program: 


puzzle with spaces — 


while len(puzzle) > Q: 
group_length — random.randint(1,5) 
puzzle with _spaces — 
puzzle[:group length]  " " 
puzzle — puzzle[group_length: ] 


Add collision detection 

It prints the puzzle _with_spaces. It then 
uses the input() function to ask you what your 
guess is. Your answer goes into the guess variable, 
and is then converted to upper case to make sure 
it matches the correct answer if it’s right. The 
if instruction checks whether guess is the same 
as chosen_phrase. If so, it prints one message. 
Otherwise, the instruction indented under else 
runs, to tell you the right answer. In Python, one = 
is used to put a value into a variable, but two (== 
are used to compare items in an if instruction. 

Add this code to the end of the program: 


print(puzzle_with_spaces) 
guess = input("What is your guess? ") 
guess — guess.upper() 


~ guess ~~ chosen_phrase: 
print("That's correct!") 
else: 
print("No. The answer is ", chosen_phrase) 


Click the Run button and hopefully you’ll see some 
letters in the Shell and ‘What is your guess¢’ Enter 
an answer and you’ll see ‘That’s correct!’ or ‘No. 
The answer is’ and the correct response. 

If you’ve typed the code out by hand, it’s likely 
that you’ll see an error message. Go through your 
code line-by-line and compare it to the full code 
in quiz_game.py. 


quiz_game.py 


Language: Python 


001. 
002. 
003. 


004. 
005. 
006. 
007. 
008. 
909. 
010. 
Oi. 
Oi. 
013. 
014. 
Q15. 
016. 
017. 
018. 
G98 
920. 
Pe 
Q22. 
923. 
Q24. 
O25. 
Q26. 
Q27. 
028. 
Q29. 
930. 
S/BuL 
G32. 
933. 
934. 





magpi.cc/github82 


suielerenemm ar-latele)(|) 


questions = ["As You Like It", "The Tempest", 

"Measure for Measure", "Much Ado About Nothing", 

“The Comedy of Errors", "King Lear", "Cymbeline", 
"Hamlet", "Coriolanus", "Othello","Love's Labour's Lost", 
"King John", “Julius Caesar", "Edward III" | 


chosen_phrase = random.choice(questions ) 
chosen_phrase = chosen_phrase.upper() 


vowels 
puzzle = 


[A Las a lias Olen "Ue; W Bi ev 


for letter in chosen_phrase: 
if not letter in vowels: 
puzzle += letter 


puzzle with_spaces = 


while len(puzzle) > 0: 
group_length = random.randint(1,5) 
puzzle with _spaces +— puzzle[:group_ length] + 
puzzle — puzzle[group_length: ] 


print(puzzle_with_spaces) 
guess = input("What is your guess? ") 
guess = guess.upper() 


_* guess == chosen_phrase: 
print( That s correct! ~) 
else: 
print("No. The answer is 


,» chosen_phrase) 
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Build an LED torch 


and electronic game 


Discover how easy It can be to get lights blinking and buttons clicking using 

































that you can easily hook up your own electronics 
projects. Using some electronics components and 
the GPIO Zero library, you can program a puzzle game 
where you have to repeat a sequence of lights that 
gets longer each turn. You might remember a similar 
electronic game from your childhood, but we call ours 
Simple Brian. In The MagPi issue 77 (magpi.cc/77) 
we showed how to use Python code to play the game 
on screen. Here, we’ll show you how to make the 
electronic game itself, building on your new-found 
Python skills from Missing Vowels. 
First, we’re going to show you how to build a 
torch by lighting up LEDs. Let’s get going. 


0 ne of the best things about the Raspberry Pi is 


Connect your first button 
The torch circuit diagram (Figure 1) 
shows an LED light connected to the GPIO 
pins of a Raspberry Pi using a breadboard 
(see magpi.cc/breadboard for a primer 
on using this piece of equipment). 
Press the button into the board, 
then use jumper wires to form a 
circuit with your Pi, as shown by 





You'll Need 


> 4x LEDs (ideally 
different colours) 


> 4x 330Q resistors 


> 4x 6mm Tactile 
momentary 
button switches 


> 400-point 
breadboard 


> 9 x Male-to-female 


jumper cables The online documentation for GPIO Zero 


(magpi.cc/DPyuYc) provides more code 
examples, including a button-controlled camera, 
an LED bar graph, and a motion sensor. We 
surveyed useful resources for basic electronics 
in issue 77, and there's a book in our Essentials 
series called Simple Electronics with GPIO Zero 
(magpi.cc/gpio-zero). 


> 8 x Male-to-male 
jumper cables 


> PiBow case with 
Breadboard Base 
pimoroni.com 


30 | @ Get Started With Raspberry Pi 


GPIO Zero and use your new-found skills to build an electronic game 


the yellow wires in the diagram. The first button 
connects to the GPIO 2 pin on one side, and to 
the ground rail on the other side. We’1l connect 
the latter to a ground pin on the Pi, so anything 
plugged in that row of holes connects to ground. 


Connect your first LED 

Always use a resistor when you connect an 
LED to your Pi, to prevent the LED drawing too 
much current and getting damaged. Both the LED 
and the resistor plug straight into your breadboard. 
The current flows from GPIO 18, through the 
resistor, through the LED (lighting it up), to the 
breadboard’s ground rail. LEDs only work one way 
around: the short leg is the negative side, which 
you connect to ground. The LED won’t light up yet. 


Make an LED torch 


You’ve made your first circuit! Let’s test it 
by coding a torch. The torch. py code shows how to 
use an LED and a button. It imports the relevant 
parts of the GPIO Zero library, then sets up an LED 
called light, connected to GPIO pin 18. The button 
On pin 2 is set up with the name button. The while 
True loop checks whether the button is pressed 
forever. If so, the light is turned on. Otherwise, it’s 
turned off. Pay attention to the capitalisation of 
LED and Button when setting them up. 





Add the other buttons and LEDs 

Take a look at Figure 2 (overleaf). It looks 

complex at first, but the other three buttons 
and LEDs are connected in the same way as 
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the first ones, just using different pins on the Pi. 
All the buttons (yellow wires) connect to the Pi’s 
inner row of pins, and the LEDs (blue wires) to the 
outermost row. We’ve separated the components 
in this diagram a bit so it’s easier to see how to 
wire it up, but try to line up your LEDs and buttons 
on the breadboard so it’s easier to play the game. 


Test them all 

Now you can test these LEDs and buttons 
too. Modify your torch code to use LED(23) and 
Button(3) and then run the program to test the 
next light switch works. Then check LED(24) and 


Button(4), and finally LED(25) and Button(17). The 


buttons should be next to the LED they illuminate. 


Build an electronic game 

Now we’re ready to start making the Simple 
Brian game (see brian.py). This starts by setting up 
a list of buttons, and a list of their associated LEDs. 
It also creates an empty list called sequence, which 
we’ll use for the sequence of lights the player must 
repeat. With each turn, it’ll get longer. 


Yofomaulaadielats 


Functions enable you to bundle up a set of 
instructions so you can reuse them. You have to 
define a function before you can use it. To define 
a function, you use def, followed by the function 
name, (), and a colon. The brackets are there to hold 
any info you’re sending to the function, but we don’t 
need to send any so they’re empty. You can tell 
which instructions belong to a function, as they’re 
indented. The lights _on() and lights_off() 
functions use a loop to go through all the items in 
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button), you can make a push-button torch 


torch.py 


Language: Python magpi.cc/github82 











+: a Ko) are ae =111(0) 
Q02. ~rom gpiozero impor= Button, LED 
003. 

Q@@4. light - LED(18) 

Q@5. button = Button(2) 


006. 

007. while True: 

008. i+ button.is_ pressed: 
Q09. light.on() 

010. else: 


light.off() 
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game features four LED lights that flash up a 
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push these to repeat the sequence of lights that 
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At the heart of our project is the Raspberry Pi. 
ai akcmeleincelatcw-lalem ilelaliciela-mexolalal-ceik-remKomelel a 
computer with wires. Code in the computer 
flashes the lights and keeps an eye on the 


buttons we're pushing 
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the leds list, putting them into led, then turning 
led on or off. The flash_al1() function shows how 
to repeat a set number of times, in this case 3. The 
loop turns the lights on and off, with a 0.25 second 
pause after each change using sleep(@.25). 


Lights test flash all 


After you’ve entered the functions (down 

to line 23), you can test the program by adding 
flash_all() as the last line and then running it. 
All the lights should flash together, three times. 
Delete that test line before you carry on. In line 

25, the program runs the lights_of#f() function to 
ensure the lights are all off before the game begins. 





Add to the sequence 

Now we enter the main game loop, under 
while True (line 27). Everything from here on in is 
indented to show it belongs to that loop, repeating 
endlessly. The game sequence Starts as an empty 
list, so the first thing we do is to add an LED. We 
pick a random LED using random. choice() and 
add it to the end of the sequence list using the 
append() list method. A list method is a built-in 
Python function that you can apply to a list. Other 
methods are available to insert and remove items, 
and sort the list, among other things. 


Play the list sequence 

The lights all flash three times using the 
flash_all() function before the sequence begins, 
to show this is the start of the sequence. Then a 
loop is used that takes each LED from the sequence 
list, and puts it into light, in turn. It’s turned on, 
there’s a short pause, then it’s turned off. There’s 
another short pause so it’s obvious there are 
multiple flashes of the same light if it repeats in the 
sequence. In round one, there’s only one light in 
the sequence list, but as the game progresses, this 
loop will get longer. You can run the program at this 
point to see the light sequence gradually extend, 
without the player getting a chance to guess. 


Get the player’s guess 
Getting the player’s guess uses a similar 
loop to the one that plays the lights sequence. It 


brian.py 








Language: Python magpi.cc/github82 

Q@1. from gpiozero import Button, LED Q34. 

Q02. from time import sleep Q@35. # play the sequence 

Q03. import random Q36. for light in sequence: 

204. Q37. light .on() 

@@5. buttons = [Button(2), Button(3), Button(4), Q38. sleep(@.5) 

Button(17) | Q@39. light .off() 

@06. leds = [LED(18), LED(23), LED(24), LED(25)] Q40. sleep(@.25) 

007. Te 

Q08. sequence — [] Q42. # get the player's input 

09. 043. for light in sequence: 

2 eo (=p oe 24 a ko) 01 @ 044. guess = None 

Q11. for led in leds: Q45. while guess == None: 

Q12. led.on() 046. for button in buttons: 

Q13. Q47. if button.is pressed: 

Q14. def lights off(): 048. # convert button push to list 

Q15. for led in leds: um ate(=>@maleliilel=ie 

Q16. led.off() Q49. guess = buttons. index(button) 

017. 050. 

Q@18. def flash_all(): Q@51. -+ leds[guess] == light: 

Q19. 0) a a Ba ar 0 24>) GD Q52. light.on() 

Q@20. lights_on() Q@53. sleep(@.5) 

Q21. sleep(@.25) Q54. light.off() 

Q@22. lights_off() Q@55. sleep(@.25) 

Q@23. sleep(@.25) Q@56. else: 

Q24. Q57. print("You failed at level ", 

Q@25. lights off() len(sequence) ) 

Q26. Q58. for _ in range(1@): 

Q@27. while True: @59. light.on() 

Q@28. # Add a new light to the end of the sequence 060. sleep(@.15) 

Q@29. new_light = random. choice(leds) Q61. light .off() 

Q30. sequence. append(new_light) 62. sleep(@.15) 

Q31. 063. sequence = [] 

Q@32. # Flash all before playback 064. break 

Q33. flash_all() 
works its way through the sequence list, accepts a Check the player’s guess ; 
guess, and checks whether it matches the current We’re still inside the loop going through [ee TI p we 
item in the sequence. There are three loops inside the sequence here, as the indentation of line 51 
each other here. The program sets the guess shows. Now we check whether the light the player Gyale[=]acyele) alate} 
variable to None, a special value in Python. Then guessed (leds[ guess ]) matches the current light in repetition 
a while loop keeps repeating until the guess the sequence. If so, the light is turned on and then 
variable changes. Inside that, a loop goes through off again. If the two lights don’t match, the player The line for _ in 
the buttons list, checking each one in turn to see made a mistake. We can tell how long a list is using fous 3 an a 
whether it’s pressed. If so, the guess variable is len(listname). We use the length of the sequence ee 
changed, ending the while loop. The program list to tell the player which level they got to. The times. The _ 
converts the button the player pressed into its correct light is then flashed quickly ten times. The shows we don't 
sholel=p.qpalepenlol-ympsemnaalcmelim-pelemolelncmmer-lapselnemmal= sequence list is emptied to start a new game, and the need to use the 
guess variable. That way, we can match the button break instruction breaks out of the for loop that’s loop number. 
to its LED, which will be at the same position in the getting player input. When the player has either Cae tems) 

; : ee : ; : : use a variable 
leds list. You can find the position of an item ina guessed all the lights, or failed, the game repeats ene re 
list using listname.index(item). from line 28, adding a new light to the sequence. M 
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Discover the easy way to control GPIO pins on your Raspberry Pi 


You'll Need 


Rasbperry Pi 
Breadboard 
EDs 

Button 


Jumper cables 
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The LED is wired up to One leg of the 
GP1O17 via a resistor. When olULaKe) gM i-Meve)alal=vedk-vo MKem dal=) 


GPIO Zero detects a button ground rail. The other leg 
push, it lights up the LED is connected to GPIO 21 
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07 Adding a button 

Now we’re going to add a button to our circuit and 
connect it to GPIO 21 with an LED wired up to GPIO17. 
Buttons are wired up in a Similar fashion to LEDs, using 





female-to-male jumper leads. 

Like LEDs, buttons have legs. One leg is wired to a GND 
pin (via the same ground rail you’ve been using for LEDs); 
the other leg is connected to a GPIO pin. Some buttons 
have four legs, so you can connect them to the breadboard 
with their legs straddling the central groove (see the 
breadboard diagram). 


Button responder 

Unlike LEDs, you don’t need to use a resistor with 
a button. The button’s legs are the same length, and it 
typically doesn’t matter which way around you hook it up 
to the breadboard. 

When the button is pushed, it forms a connection 
between the ground rail and the pin, completing a circuit. 
The Raspberry Pi is set up, using GPIO Zero, to detect this 
connection and respond. 

Open Thonny and create a new file. Enter the code from 
button.py, save the file, and run the code. When you push 
the button, the LED will light up. Hl 















DOWNLOAD 
THE FULL CODE: 


y) magpi.cc/2ehTqVq 


button.py 


> Language: Python 












Q01. from gpiozero import LED, Button 
Q02. from signal import pause 

203. 

@@4. led = LED(17) 

Q05. button = Button(21) 

Q06. 

Q07. button.when_pressed = led.on 
008. button.when_released = led.off 
Q09. 

pause() 


traffic_lights.py 


> Language: Python 





Q01. from gpiozero import LED 
Q02. from time import sleep 
003. 

04. red = LED(25) 

Q@05. amber = LED(8) 

Q@06. green = LED(7) 

Q07. 

Q08. green.on() 

Q09. amber.off() 

Q10. red.off() 


011. 

Q@12. while True: 
Q13. sleep(10) 
Q14. green.off() 
Q15. amber .on() 
Q16. sleep(1) 
Q17. amber .ofF() 
Q18. red.on() 
Q19. sleep(10) 
Q20. amber .on() 
Q21. sleep(1) 
Q22. green.on() 
Q23. amber .off() 
Q24. red.off() 





Going further aM as 
MagPi 
You can achieve a lot more with GPIO Zero than Cy h APT. E 
controlling LEDs and buttons. WSL | 
nee ELECTRONICS 
For a more detailed look at how you can detect WITH 
motion, control robots, read sensor information (such ) GPIO VAAS1@) 
as movement sensors or thermometers), we have pe 1-OF THE REAL W Rj 
created a fantastic guide book: The MagPi Essentials: _ pe Me 


Simple Electronics with GPIO Zero. Learn more at 





magpi.cc/gpio-zero. 
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This humble plastic block full of holes can be used to create just about anything 
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lf you have bought a Raspberry Pi to learn how to code 
and hack new electronic gizmos, then you have made 
a great choice. Get started with this guide... 
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f you have just got a brand new 

shiny Raspberry Pi, you may have 

plugged it in and got it working. 
You may have played a few of the games 
or tried out the applications, or maybe 
you’ ve loaded one of the programming 
tools and then looked at it wondering 
what to do next. If you haven’t done 
any programming before, we have 
wisdom for you here. In the next few 
pages you’ll find answers and probably 
some questions, but then some more 
answers. Before you know it you will be 
a coding, hacking ninja. 


rf you have never done 
any prograkaming belove Lhis 
may appear a bit daunting 
but, it's quite easy really 


If you’re new to programming, this 
may appear a bit daunting, but it’s 
quite easy really — you’ve just got to 
get stuck in and start with some simple 
things that will get you results. One 
of the programming languages that is 
supplied with Raspberry Pi is Python. 
It’s very easy to get started with Python 
and it can be used to program many 
of the add-ons that are available for 
Raspberry Pi — so this is going to be 
very useful to learn. We can get you 
up and coding in 30 seconds flat; just 
keddsolles 








oe 
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A 
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To get started with coding is really easy. Coding 
is just giving a Raspberry Pi an instruction to do 
something. The only thing you need to know Is 
what language to talk to it in. In this case we are 
going to talk in Python 3. We will need to write 
our instructions Somewhere so, to start, open a Ma ne 
Terminal window - click the icon in the top left 
of the screen which is a grey box with a blue bar Vanstone 
across the top. This opens a black window with a 
prompt: pi@raspberrypi:~ $ in green. If you type 
python3 and hit ENTER, Python starts and you 
will see the triple chevron prompt: >>>. Now type 
print("Hello" ) and hit ENTER. Bosh! Your first 
program. You have instructed your Raspberry 
Pi to print the word ‘Hello’ and, all being well, 
it has obeyed. 
Entering programs like this is not going to be 
very useful most of the time, so now let's look at 
an app we can write and save a program with. 
Go to the desktop menu (click the Raspberry 
Pi logo in the top left of the screen) and in the 
Programming section, select Thonny (which 
should then open by default in its Simple mode). 
Try typing in the following program tn the 
Thonny editor and save it, then run it by clicking 
the Run button. The output will be displayed in 
the Shell frame below the program editor. 


mwc1.py 


. import random 


- correct = False 
r = random. (1,10) 
- C=0 
. while correct == False: 
n = ("Guess my number between 1 and 10: ") 
c=c+t+i1 
if (n) == r: 
correct = True 
else: 
if (n) > Pr: 
("Sorry, my number is lower. Try again.") 
else: 
("Sorry, my number is higher. Try again") 


("Well done. The correct answer was " + (r) +". 


You got it in " + Cop ee a a = | 
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using several elements. let's take 


a look at a range of them and how they work 
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n the last program, we get input from the 
keyboard and output text and numbers by 
using the print() function. We have also used 





a condition structure in the form of if and else. 
Python is very particular about how you indent the 
code with spaces (four per indent level); this shows 
that the indented code is inside another structure. 
In the last program, everything indented after the 
while statement will be part of that loop. Let’s take 
a look at a few more coding techniques. 


Tan) exe) magteye(bK=s-3 


Make new 


ValwV (=) ida lale| 
Define data 


Wali Rem alo milalyalzxe b 
Ta) oLelmat=oyme [Coss 


Player wins Player loses 





A After initialising the data the program 
needs, we loop round, updating the 
answer variable until the player guesses 
all the letters or they run out of tries 









theWord. When we call a function that is inside 

a module, we use a full stop between the module 
name and the function name. Next, we want to get 
the player to start guessing what the word is. If we 
look at the bottom of the code, we can see that we 
call a function called startGuessing(). This is our 
own function that we need to define. 





01 Using lists 
We are going to write a Hangman-style 


game, where we Start with a secret word and the 
player has to guess it, letter by letter. If correct, we 
show them where that letter appears in the word. 
They are allowed ten wrong attempts before the 
game ends. See the mwc2.py code to follow along. 
First, we make a list of words to choose from. A 
list is defined in Python using square brackets, 
like: list = ["a","b","c"]. We'll call our list 
WORDLIST. In this case we’re writing the list name 
in upper case to show that it is aconstant, 1.e. It is 
not going to change throughout the program. 





Pick a word 

We can pick a word from our list using the 
random module. We import the module at the top 
of our code, then we can use the random. choice() 
function to get a word and Store it in a variable: 
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03 Defining functions 

Each time we call a function, the code inside 
it runs. Sometimes functions have outputs, like our 
function updateAnswer() that returns the variable 
result. One of the rules of Python is that you must 
define a function before you call it, so we will need 
to define our startGuessing() function near the 
top of the code. To do so, we write def and then the 
name of the function, followed by brackets anda 
colon. If we want to pass variables as inputs into a 
function, we can add them inside the brackets. 








Getting loopy 

Now for the code in our startGuessing() 
function. We set the number of tries and dashes, 
one for each letter of the secret word, then we go 
into a loop. The code says: “While the player still 
has some tries left and the answer we have is not 
the secret word, run the following code.” In our 
loop, we print the answer we have so far and how 








FEATURE 


imwe2.py 


ava taeda) 

001. lar-Tarekeyi 
002. 
003. WORDLIST [ 5 5 ‘ 5 

, , ] 
2] <) mn of X=) 0) axe Mm ar- Tae (ei Pol atom melon @)(0),(D) iv 0D) 
005. 
G06. def er 
007. triesLeft = 10 
008. answer len(theWord) 
009. 
010. triesLeft 1 answer theWord: 
oh i print("\n answer ) 
he print(str(triesLeft) ) 
013. guess = input( ») 
e14. len(guess) 1: 
Q@15. print( ) 
016. guess theWord: 
he print( ) 
018. answer = updateAnswer(theWord, answer, guess) 
019. : 
Q20. print( ) 
@21. triesLeft 1 
@22. 
023. triesLeft < 0: 
Q24. print( theWord) 
@25. : 
Q26. print ( theWord) 
Q27. 
Q@28. def ; ; ): 
Q29. result 
030. i range(len(word)): 
Q31. word[i] guess: 
Q32. result result + guess 
Q33. : 
@34. result = result + ans[i] 
Q35. result 
036. 
Q@37. print( ») 


@38. startGuessing() 


many tries the player has left. Then we use an if, 
elif, else condition structure to respond to the 
player, depending on what they typed. 


05 Changing the answer 


If the player guesses a letter correctly, we 
call another function: updateAnswer(). This 
uses a for loop to add the correct letters into 
our answer variable, then return that string (a 
variable containing letters/characters rather than 
a numeric value). This then becomes the answer 
variable that we print at the start of each loop in the 
startGuessing() function. When the player has 





euessed all the right letters in our word or they have 
got it wrong ten times, the program will drop out of 
the loop to reach the final part of the function. 


Win or lose 

We have an if and else structure to print 
congratulations, or let the player know they’ve run 
out of tries. A few of the functions are used with 
variables: len() finds the length of a string, and 
str() converts a number variable into a string so 
it can be added to the start or the end of another 
string. After the function is complete, it returns to 
where it was called, which is the end of the program. 
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FEATURE 


Now we ve got Vie 


PN 0) g=ys\e|eleysl ce! 


A resistor 


2 x male-to-female 
jumper wires 
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rang of the toding, let's put 


it to work with some elecbronte components 














into our code and used functions from it. If we 

want to control electronics from code, there 
is a very useful module available called gpiozero. 
GPIO stands for ‘general-purpose input/output’ 
and the line of double pins on one side of your 
Raspberry Pi are called GPIO pins. For details about 
the labels of all the pins, see pinout.xyz. If we 
connect electrical components to these GPIO pins, 
we can use the gpiozero module to make things 
happen. When we import a module, there are often 
many different functions inside. We can also make 
new coding ‘objects’ with them. Objects are like 
variables but have their own set of functions and 
properties inside them that we can call or change, 
and we do that using the same dot notation (full 
stop) that we did with the random module. For 
more details on using coding objects (called object- 
oriented programming or OOP), see issue 54 of 
The MagPi: magpi.cc/54. 


[ n the previous example, we imported a module 





The breadboard 


Breadboards come in various sizes, but 

they all work in the same way. If there are tracks 
marked red and black/blue (and/or + and —) on the 
long edges of the board, these are for power and are 
connected along the length — although sometimes 
divided into sections. The matrix of holes which 
make up the main part of the board are connected 
in lines the other way (vertically in the diagram). 
There is usually a break in the centre of the board 
so that the two sides are not connected. 





02 Light-emitting diode (LED) 
An LED is a bit like a bulb in that if you apply 
electricity to it in the right way, it ights up. An LED 
is also a diode, which means that the electricity 
needs to flow in the correct direction or it will not 
light. When connecting an LED to Raspberry Pi, we 








need to add a resistor to the circuit, 
as most LEDs will burn out if we 
connect them directly to the main 
power output. In the example, we are 
using a1kQ. resistor, but it’s fine to 
use another similar value. To light 

an LED using gpiozero, assemble 
the components as in the diagram, 
then write a Python program: start 
with from gpiozero import LED, 
then create an LED object with led = 
LED(17), and finally type led.on() 
to light the LED. 


A resistor 

Resistors do what their name 
suggests: they resist the flow of 
electricity (current). Some components 
need to have a certain amount of current 
in order to operate correctly. Resistors 
enable us to set the current or voltage to 
a Suitable level for the other components 
we are using. There are many different 
types of resistors, with different 
resistance values. The resistance value | 
can be read from the pattern of coloured 
stripes on the resistor. You can also 
get variable resistors, which are known 
as potentiometers. 


Jumper wires 

We need to connect 
our components to 
Raspberry Pi’s GPIO pins. 
For this we use jumper 
wires. The ones we will 
be using have a female 
connector at one end, 
to go on the GPIO pins, 
and a male connector 
to go in the holes of the 
breadboard. You can also 
get jumper wires with 
both male connectors or 
both female connectors, 
for different situations. 
They can be bought in 
strips all joined together, 
sometimes known as 
‘jumper jerky’. 
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You can control the 
state of the LED using 
the gpiozero module 
in Python 





Potentiometer 
A potentiometer is a variable resistor. It 
usually has a turning spindle that changes the 
resistance from one value to another, quite often 
from no resistance to full resistance (no electricity 
flowing). A potentiometer can provide us with 
a variable output voltage which we can measure 
with the GPIO, but there is a slight problem. The 
potentiometer provides an ‘analogue’ 
output (varies continuously 
between values) and the GPIO 
inputs are only digital, i.e. 
on or off. So we need another 
component: an analogue-to- 
digital converter (ADC). 


Eleetronits 


quide 





Analogue-to- 

digital converter 
ADC components come in various forms, but the 
one we have in this example is called an MCP3008. 
It’s an integrated circuit (IC), meaning that it’s a 
box with some circuitry inside it. We don’t need 
to know what is inside it — we just need to know 
what to connect to each of the legs of the IC. We 
will need to wire up several of the legs to GPIO pins 
and provide the IC with power; when we’ve done 
that, we can connect the potentiometer to the IC 
and then read values in 
showing the position 
of the potentiometer 
spindle using the 
gpiozero module. 
We’ll cover the code 
in the next section. 
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6 x male-to-female 
jumper wires & 

Kobe maats\(ota ters gate\l= 
jumper wires 


2 x potentiometers 


MCP3008 
integrated circuit 





— 


n the previous page we talked about 
Oo potentiometers and analogue-to- 

digital converters, and this is where 
we get to use them. It’s a bit more complicated 
than lighting up an LED, but only a little. First, 
we are going to write a program which has two 
rectangular bats at each side of the screen that 
can be moved up and down by two players. A ball 
bounces backwards and forwards between the 
bats until one player misses the ball and the other 
player scores a point. That’s right, you guessed 
it, the game is Pong and we are going to create a 
controller for each player from a potentiometer 
and wire it into our Raspberry Pi. 





Super-fast game coding 

If you have been following other coding 
articles in recent issues of The MagPi, you will 
know that when writing a quick game on Raspberry 
Pi, Pygame Zero is your friend. We can make the 
basics of the game code very quickly by importing 
the pgzrun module, which holds all the Pygame 
Zero code. We need to call pgzrun.go() at the end 
of our code, and that’s our game window sorted. As 
with all Pygame Zero programs, we have a draw() 
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Now to put what we have Covered to the test: we will make a 
retro game and control it with our own homemade controllers 


function to write the graphics to the window, and 
an update() function to update the game items 
between draw cycles. 





02 Running the code 


The listing mwc3.py provides all the code 
you need for the game to work. There is some code 
in the updatePaddles() function for the keyboard 
to control the paddles or bats, just in case you want 
to test it before making the proper controllers. We 
import several modules with this code. We have 
covered pgzrun, but we also need random so that 
the ball will move in a random direction each time 
it starts. In addition, we need gpiozero to deal 
with the input from the controllers, and we need 
the math module for calculating the direction of 
the ball. 


03 Wiring it allup 

One thing to bear in mind when connecting 
any electronics to a computer is that if the 

wires are connected in the wrong way, you may 
cause damage to the computer or the electronic 





components, so it’s always a good idea to power off 
your Raspberry Pi before connecting anything to 
the GPIO pins. Follow the wiring diagram (overleaf) 
carefully, making sure that the jumper wires are 
connected to the right GPIO pins and to the correct 
places on the breadboard. Once you have put 
everything in place, it’s a good idea to have another 
check just to make sure. 


The MCP3008 IC 

The MCP3008 converts the voltage from our 
potentiometers into a number with the help of the 
gpiozero module. It has eight channels for input, 
but we are going to just use two of them in this 


gs oP 3008-V/P ED 
= > 1608100 
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case. You will see from the diagram that all the legs 
on the top side of the IC are connected to either 
GPIO pins or to power lines. There are two red 
connections going to the positive power track, then 
a black lead to the negative or ground track. Then 
there are four coloured wires that go to: purple - 
GPIO11; green — GPIOO9; orange — GPIO10; and 
blue - GPIOo8. Then there is one last connector to 
the ground track. 


The inputs 

All the MCP3008 pins on the bottom side 
of the IC are input channels. We will use the first 
two pins, which are channel 0 and channel 1. We 


>. 


It may seem like a lot of 
wires, but work through 
the diagram methodically 
to make sure they are 
plugged in correctly 
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: eo connect the middle pins of our potentiometers to 
Si those channel pins, which will read the positions 
and convert that to a value in our program. If you 
want to know exactly what all the pins are for on 
this IC, you can do a web search for ‘MCP3008 





LanaaHa3 
CST CAMERA) 


The MCP3008 gi one Rais 

eLaddles “s pinout’ and that will give you descriptions of each. 
the centre a ICs are very useful in electronics as they mean that 
break of the =. we can reduce how complex our circuits are and we 
breadboard so don’t need to know exactly how they work inside. 
that the pins on They are a little bit like modules in Python. 

either side are 

not connected = 





06 Finishing the job 

When you have checked that all the 
connections are correct, you can switch your 
Raspberry Pi back on and reload your program. You 
may want to initialise the SPI interface on your 







st ft 8 8 o 


The left-hand | 7 \\ | 







Eee Pcs sie OEE a ke awa ae een Raspberry Pi by going to the main desktop menu 
connects to pin Sl sew aw aw eas pac an eae eews > Preferences > Raspberry Pi Configuration, and 
0, and the right : ncPaIooa go to the Interfaces tab. It will work without this, 
one's to pin 1 of | but may cause a few warnings in the Thonny shell 





the MCP3008 window. So, all being well, when you run your 
program you will have a game of Pong which can be 
controlled by two players with the potentiometers. 
If it doesn’t work first time, check your code and 


then your wiring, and try again. Hl 





A When everything is 
plugged in and working, 
you can play Pong! 
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002. 
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006. 
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008. 
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hs 
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636. 
037. 
038. 
939. 
040. 
Ts 
042. 
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047. 
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049. 


pgzrun 
lar-larele)it 
f-4 oh Koy 4-] we) MCP3008 
math 
pot1 = MCP3008(0) 
pot2 = MCP3008(1) 
# Set up the colours 
3] \ el (cr 
WHITE = (255,255,255) 
[oh BY of o) f= p2Score Q 
BALLSPEED 5 
p1Y = 300 
p2Y = 300 
def Or 
Tol al -\-]) a @ >) 1G @) 
screen.draw. line((400,2), (400,600), ») 
(oT ar-\ier-Le (en -t- @) 
drawBall() 
screen.draw.text(str(piScore) , (105, 
40), WHITE, 60) 
screen.draw.text(str(p2Score) , (705, 
40), WHITE, 2D) 
def (): 
WW oXeF- um) -y-(e(e NR @) 
updateBall1() 
def Ok 
'oy- Bi Game oy- ot A oy Dg een oy a 
y= 400 
bally 300 
a = random.randint(10, 350) 
(a > 82 a < 100) (a > 260 F) 
280): 
a = random.randint(10, 350) 
ball1DirX = math.cos(math.radians(a)) 
ballDirY = math.sin(math.radians(a)) 
def Ok 
p1Y, p2Y 
‘oy ay -\ oy SE = on ot @ @ A's] - mn oc) a QI oD 
p2rect = Rect((700, p2Y-30), (10, 60)) 
screen.draw.filled rect(pirect, ») 
screen.draw.filled_rect(p2rect, ) 
def Ok 
p1Y, p2Y 
‘ot Aw @ ole) oh MPR WO - 0 2) 
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imwec3.py 


Pyth 
p2v = ( ython 


pot2.value * 540) +30 


keyboard.up: 
p2Y > 30: 
p2Y y) 
keyboard.down: 
p2Y < 570: 
nya y) 
keyboard.w: 
p1Y > 30: 
p1Y y) 
keyboard.s: 
p1Y < 570: 
p1Y y) 


def Ok 
oY ie ee oy i A oy Dg Qe oy A 
piScore, p2Score 


bal1lX bal1DirX*BALLSPEED 

bally ballDirY*BALLSPEED 

ballRect = Rect((bal1X-4,ballY-4),(8,8)) 
fot ay -\ ou OE = ou ot @ @ A] oc) a Qi  )- 
p2rect = Rect((700, p2Y-30), (10, 60)) 


checkCollide(ballRect, pirect) 
checkCollide(ballRect, p2rect): 

bal1DirXx 1 
bally < 4 ballY > 596: 
ballDirY 1 
ballX < 0: 

p2Score 1 

init() 
bal1lxX 800: 

[oy RSX of 0) af = 1 

init() 


def (r1,r2): 
r1.x a 4 r2.w and 
rl.y < r2.y + r2.h and 
r1.x ri.w ay aa 1il6| 
ri.y + ri.h r2.y 


def OF 
Tod at =1-1 0 PR ¢ | ar-| mee le Mo aon Ad @ @ ol ml Qt oy Bl 
) 


init() 
pgzrun.go() 
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Ws =TUTORIAL 


RASPBERRY PI 
ACCESSORIES 


Our guide to the greatest add-ons, HATs, 
and expansions for your Raspberry Pi 











aspberry Pi is fantastic on its own. 
R With wireless LAN, Bluetooth, 

USB ports, the multitalented GPIO 
pins, and a full operating system, it really 
is a fully functional computer. 

What if you could make it better? Do 
more? Make certain functions easier? This 
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is where add-ons and accessories come in 
— there are hundreds of extras you can get 
for your Raspberry Pi that will improve its 
already impressive specs. 

What add-ons should you get, though? 
We’ re here to show you the best the 
Raspberry Pi world has to offer. 
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We’ ll start with an important 
one. HAT stands for ‘Hardware Attached 
on Top’ (it’s a backronym), and is a standard for 
add-ons. That means there are specific definitions of how 
a HAT can connect and work. All you need to be concerned 
with is that a HAT fits perfectly on top of a Raspberry Pi, 
connecting to the GPIO pins. You will usually need to install 
extra software to get them working. 
















While the HAT standard has recently 
been extended to different sizes, many 
companies have created their own term 
for add-ons that act like a HAT but 

IP. 10.9. 0,194 | tz > | F a je | don’t quite meet the technical criteria. 

| Men: 78/4348 17.975 | Eg) “ah = @ = |S Pimoroni coined pHAT, and Adafruit 


Disk: S78/15en 9% 
uses Bonnet, and other firms 


ay : tend to use similar 
2 ‘ion == i , variations on the 

} at as : headwear theme 
or HAT. 


+m 12C_Pi OLED 


A HAT is an add-on, but an add-on isn’t necessarily a HAT. 
Add-ons can be connected via USB, only specific GPIO pins, 
the camera port, etc. It’s a catch-all term for something 
that you can add onto your Raspberry Pi in some way. 
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PROGRAMMING AND 
MAKER ACCESSORIES 


Improve your projects with these add-ons 







ThunderBorg 


magpi.cc/xcsSpm 
price: £37 / $50 


This dual motor control 
board by the folks at 
PiBorg is a powerful 

and robust way to use a 
Raspberry Pi to control 
a robot. As well as being 
able to make the motors go 
forward and back, it can control 
the speed for more precise 
manoeuvring, and can take a 


wide array of power inputs. magpi.cc/sense-hat 


price: £30 / $37 


Developed for the Astro Pi mission, the Sense HAT is primarily a set of 
environmental sensors. It can detect pressure, humidity, temperature, and 
orientation/movement. It also has an 8x8 LED matrix and a little joystick for 
very basic display and control. There are a couple of Sense HATs running on 
Raspberry Pi boards up on the ISS at the moment. 
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I 
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I 
I 
I 
I 
I 
I 
Use it with: Robots, RC cars 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
I 
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Use it with: Weather stations, space stations 


Hologram Nova 






hologram.io/nova 
price: From £53 / $64 







Despite the world’s best efforts, WiFi is not 
available absolutely everywhere yet. You can’t even plug an 
Ethernet cable into a tree! The Nova solves this problem by letting you connect 
to cellular networks around the world on your Raspberry Pi via this USB device. 


Use it with: Portable projects, outdoor cameras 
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magpi.cc/TFLQpM 


Edge TPU Accelerator | ! 


price: £61 / $75 


I 

I 

I 

I 

I 

I 

I 

Google was responsible for the AIY 
Voice Kit — a special HAT and extras 
1 that lets you turn a Raspberry 
Pi into an AI voice assistant. 
The Edge TPU accelerator 
I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 
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Cluster HAT 


aims to help Raspberry 
Pi out with AI tasks, 
and make your voice 
assistants better. 





magpi.cc/Qrshbi 
price: £31 / $37 


Use it with: Voice control, Al 
projects 


I 

I 

I 

I 

I 

I 

I 

Putting Raspberry Pi boards into 
a cluster isn’t that tricky, but 
; the Cluster HAT makes it very 
i easy. Using one Raspberry Pi, 
! you can distribute computing to 
I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 
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ee 


up to four Raspberry Pi Zeros. 
Cluster computing is a great 
way to perform different kinds 
of calculations. 
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Use it with: Mathematics, 
big algorithms 


Ultimate GPS HAT 


magpi.cc/vmPqLL 


* price: £42 / $45 


i 


‘ 


GFX HAT 
Raspberry Pi — well, as precise 


I 
I 
I 
I 
I 
I 
I 
I 
I 
track the precise location of your 
I 
% I 

magpi.cc/ZWvcLG £22 / $22 : as GPS can be. You’ll have to 
1 combine the position data with 
map data to make much use out 
' Of it, but once you have it all 
; 
I 
I 
I 
I 


working it’s pretty fantastic. 


A very functional screen that draws a lot less power than most displays, it also 
includes six capacitive touch buttons for control. It’s the successor to an excellent 


add-on known as Display-O-Tron, and makes interactive projects look great. 
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This GPS add-on allows you to 
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Use it with: Thermostat, practical projects 
I 
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Use it with: Sat-navs, route tracking 
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Using a Raspberry Pi for 
enterprise? You may want 
to check these out... 





gee ¢ 


magpi.cc/FnezCP 
£22 / $27 


Another remote-control power 
solution, this one is designed for 
Raspberry Pi to control power 
elsewhere. There are various 
Energenie Pi-mote products, 
the cheapest starting at £10, 


"Raspberry Pi PoE-HAT | ° 
. fe) Raspberry Pi 2017 


but the starter kit version also magpi.cc/aqpwZc £18 / $22 

includes compatible sockets. 

You can even get a Pi-mote Raspberry Pi3B+ and 4 models include proper Power-over-Ethernet support, 
that allows the plugs to talk to although you need one of these HATs to get it working. Of course, the network 
Raspberry Pias well. needs to be set up to support (i.e. power) the PoE and Raspberry Pi combo. It 


Use it with: Timed-lighting, also currently only works on Raspberry Pi 3B+ and 4. 


some loT Use it with: Server racks, headless solutions 


magpi.cc/merPpf 
£20 / $25 


Serious Raspberry Pi users often need power management and a real- 
time clock (RTC) for various reasons. The Witty Pi 2 offers these things, 


a st ms, + -\eer along with some extra on/off functions that can programmed. As 
oy afault OF st ie, BA4S Spey? | pce Oe : , 
Deeaitt oO Sy “ae rete Raspberry Pi normally requires the internet to check the time, an RTC is 
q i 4 i aio Hie | ee i =, a . . . ) . 
m8 qth ikl bao . a7 0B essential for scheduling tasks on a Raspberry Pi that’s not online. 


$f 


custom 
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£ Use it with: Industrial settings, automated solutions 
| 
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dinrplate.com 
From £10 / $13 


Want to use a Raspberry Pi in a server environment, but don’t 
need a UPS or RTC or any of the advanced stuff like that? Just 
have some DIN rails handy anyway? Then the DINrPlate is an 
excellent add-on that lets you mount a Raspberry Pi to a DIN 
rail without any fancy extras. And the price reflects that. 
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Use it with: DIN rails, DIY servers 
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magpi.cc/rfBfvo 


magpi.cc/ZvcsrZ £18 / $22 
| price: From £206 / $266 
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Are you a sysadmin in a big 
company that would like to use 
Raspberry Pi boards? The Strato 
Pi turns a Raspberry Pi intoa 
server good enough to pass 

the rigorous tests of enterprise 
IT. It has an impressive list 

of features: RTC, UPS, two- 
module DIN-rail case, RS-485, 
and more. 
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Use it with: Enterprise, servers 


Ad QO 


On/off switch solutions for Raspberry Pi have 
been around as long as Raspberry Pi itself, 
but none of them has been that great. 
Along comes the Hackable Pi Switch 
Cap from Nanomesher and finally we 
have one that does everything you 
need. By default, it allows you to turn 
your Raspberry Pi on and off witha 
button, and you can reprogram it to 
do more with an included remote. 


Use it with: Desktop Pi, HTPC Pi 
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Improve your listening, watching, and more 


magpi.cc/aimAyy 


price: From £20 / $24 


There are many digital-to-analogue converters (DACs) 
that turn Raspberry Pi into a powerful stereo, but we’re 
partial to the HiFiBerry DAC+ range. There are cheaper 


versions, smaller versions, more powerful versions, and 
all of them improve your Raspberry Pi’s sound. 


Use it with: Stereo system, PA 
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PF: o,* HIFIBerry magpi.cc/WgSmAA 
33 From £37 / $37 


The HyperPixel 4.0 is a massive, wonderful screen 
for Raspberry Pi that you can get with or without a 
Capacitive touch function. It’s dead simple to set 
up and, due to the high pixel density, it’s great for 
watching media or looking at pictures. 


Use it with: Portable media projects, wall screens 


magpi.cc/2ve6iUo 
£6 / $7 





If you’re playing retro games with your Raspberry Pi, you 

might want a retro controller to help it feel more authentic. We 
recommend one of the many available in this classic style, with enough 

buttons to play any game prior to 1996 and some afterwards as well. 


Use it with: Retro games console, RC car projects 
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magpi.cc/ryviXi price: £20 / $25 


The official Raspberry Pi TV HAT is pretty amazing — its most basic 
function is allowing you to tune into TV signals using your Raspberry Pi. 
That’s pretty standard, but the amazing part is its ability to stream said TV 
not only around your network, but also over the internet if you’re abroad and 
missing the latest episode of GBBO. 


Use it with: DIY DVR, TV anywhere 


lightberry.eu 
From £94 / $114 
Ever wanted your films to expand out of your TV? With Lightberry, you can 


install DIY Ambilight-like effects to your TV so that special effects become 
just that little bit more special. There are various kits to choose from as well. 


Use it with: HTPCs, magic mirrors 
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flirc.tv 
From £20 / $25 


For applications such as Kodi, 
there are plenty of ways to 
control your Raspberry Pi- 
based home theatre PC via your 
smartphone or tablet. FLIRC 
makes the whole thing a bit 
simpler, though: take your 
favourite remote, let FLIRC 
know which button is which, 
and then just plug it into your 
HTPC. Simple. 


Use it with: Kodi setups, remote- 
controlled loT 





magpi.cc/BupAFF 
£16 / $16 


The Picade is Pimoroni’s 
excellent tabletop arcade kit, 
and its newest iteration is 
controlled by the powerful 
Picade X HAT. It’s so good, 
they made it so you could buy 
it separately to use in your own 
DIY Raspberry Pi arcade setup. 


Use it with: Arcade builds, 
remote controls 
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with the TV HAT 


Set up your new ddd-on to stream live TV from and to a Raspberry Pi 


Phil 
King 


When not subbing 
The MagPi and 
editing Raspberry 


Pi books, Phil he latest official Raspberry Pi add-on is 

sa Role a must for telly addicts. The Raspberry Pi 

eee TV HAT enables any Raspberry Pi (with Assemble and mount 

Crown) and other 40-pin GPIO) to decode live digital TV signals and Insert the thin end of the supplied silver RF 

(old Dynasty stream them to remote devices — such as another cable adapter into the gold connector on the side of 

oe Raspberry Pi, computer, or even a smartphone. the HAT. Take the 40-pin header and insert its pins 
The HAT’s built-in Sony CXD2880 tuner supports into the holes in the underside of the HAT — not 
DVB-T2 and DVB-T standards (Freeview in the UK), into the black female header on the top! Mount the 

P so you can watch all your favourite channels. Here HAT on your Raspberry Pi, with the RF adapter at 

You'll Need we show you how to set it up, and even use it to the microSD card slot end. To make it secure, you 

turn a Raspberry Pi into an all-in-one TV/PVR. can screw it in using the supplied stand-offs. 


Raspberry Pi TV HAT 


Wireless network 


Computer 









Mays 
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Top Tip 


Recording ni oa 
= a 
Add a hard drive ai = 
or USB stick to =~ SS ee - os 
Raspberry Pi to turn 1 oa 
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it into a capacious 
homemade PVR 
with LibreELEC. 


Connect your TV aerial [= — eae cael / ) With the supplied header 


cable to the HAT via 
idalomo1ble)e)i(-rem\el-le)K-14 
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HAT is mounted on Raspberry Pi 


Install Tyheadend 

Connect a coaxial RF cable from a TV aerial 
socket to the RF adapter on the HAT. You’1l need 
decent digital terrestrial TV (Freeview in the UK) 
reception for the tuner to work. With Raspbian 
Stretch installed on its microSD card, turn on your 
Raspberry Pi — a green LED will light on the HAT. 

We need to install a back-end TV service to 

stream video: we’ll use Tvheadend. To install it, 
open a Terminal window and enter: 


sudo apt-get update 
sudo apt-get install tvheadend 


Configure Tvheadend 

It takes a few minutes for Tvheadend to 
install, so you may want to go and make a cup 
of tea. Once installed, a package configuration 
screen will appear and you’1l be prompted to 
enter a Tvheadend administrator user name. 
For simplicity’s sake, enter kodi for this, then 
also enter kodi for the password — you can always 
change it later if you prefer. You’re now ready 
to log in from another device. 


Log in remotely 

Now that Tvheadend is running, you can 
access it from another computer (possibly a second 
Raspberry Pi). In a web browser, enter this address: 
http://raspberrypi.local:9981/extjs.html. If that 
doesn’t resolve, use your Raspberry Pi’s IP address 
instead, followed by :9981/extjs. html. Log in 
using kodi for both the username and password. A 
configuration wizard will appear, enabling you to 
choose the TV network type and transmitter. 


Configure TV network 

In the configuration wizard’s ‘Network 
settings’, it should show “Tuner: Sony CDX2880 #0 
DVB-T #0’. For the Network Type, choose ‘DVB-T 
Network’. For predefined muxes, select your local 
transmitter: for example, ours was uk-Rowridge. 
Upon clicking Save & Next, it’1l start scanning for 
muxes and services (channels). After it reaches 
100%, tick all three boxes (Map all services, 
Create provider tags, Create network tags) and an 
electronic programme guide (EPG) will appear. 
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Watching TV 

You can now watch live TV streamed from 
the TV HAT in your browser. In the EPG, click the 
TV icon to the left of any programme to show it in 
a window, which you can expand to full-screen. 
There are also options to schedule and record 
shows — use the Help option for more details. 

As well as using a web browser, you can view 
the TV stream from a variety of clients, including 
Kodi, omxplayer, VLC, and smartphone apps — 
see magpi.cc/ZpJtwd. {i 


Using LibreELEC 


The live TV stream from the TV HAT can be accessed 
in the Kodi media player, most easily by using 

the LibreELEC OS on a Raspberry Pi. Install the 
Tvheadend client by selecting Add-ons > Install from 
repository > PVR clients > Tvheadend HTSP Client. 

In addition, using LibreELEC, it’s possible to set up 
both the Tvheadend client and server on the same 
Raspberry Pi - a Pi 2, 3, 3A+, 3B+, or 4 is recommended 
- for an all-in-one TV/PVR device. To do so, select 
Add-ons > Install from repository > Services > 
Tvheadend Server 4.2, and install it. Access it from 
another computer using the IP address followed by 
:9981 and set it up as in Step 5. You can then access 
it from within LibreELEC (with the Tvheadend client 
installed) by selecting the main ‘TV’ option. 

To make TV recordings, you'll need to create a 
recordings folder on a connected USB stick or hard 
drive - navigate to it in File Manager, right-click, 
and select ‘Make new folder’). Then, in the web 
interface on a remote computer, go to Configuration 
> Recordings and set the recording system path to 
var/media/lyour_drive_namel]l/recordings. 
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You can access 
the EPG and 
watch live TV ina 
web browser ona 
remote computer 


TopTip @ 


Live viewing 


The live TV stream 
can be accessed 
in many ways, 
including Android 
and iOS apps. 
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Marc Scott 





Marc Is a former 
teacher of 
Computer Science, 
and Is currently a 
learning manager 
at the Raspberry 
Pi Foundation. 


magpi.cc/ZHdSsd 


You'll Need 


>» Raspberry Pi (nota 
Zero / Zero W) 


>» Sense HAT 


> Speakers or 
headphones 


Make a Sense HAT 
MP3 player 


Turn g Raspberry Pi and Sense HAT 
accessory Into gn MP3 player 








MP3 player using a Raspberry Pi and a Sense 

HAT. You’ll be able to shift between tracks in 
your playlist, change the volume, and show a cool 
disco display on the LED matrix. 


n this project, you will be making your very own 


Get set up 

Open up Scratch 2 on your Raspberry Pi 
(choose Menu > Programming > Scratch 2). Now 
choose a sprite for your MP3 player. Right-click a = 
on the cat sprite and choose Delete. Click on the A. Step 1 Add the Speaker sprite 
‘Choose sprite from library’ icon; now choose 
Things in the sidebar and highlight Speaker. Click 
OK to add it to the Stage. It will add some blocks to 
the scripts area — right-click to remove them. 








Add GPIO support 

A special GPIO extension in Scratch 2 on 
Raspberry Pi is needed to control and read input 
and output components connected to the GPIO 
pins. With Scratch 2 open, click on More Blocks 
in the Scripts menu. Next, click on the ‘Add an 
Extension’ button. You can then double-click on 
the ‘Pi SenseHAT’ extension to add it. You should 
now see the Pi SenseHAT blocks in the More 








I 
I 
Blocks section. 
Cm 
x 
a 
r Le: a 
SE 
8 ig 
Create a disco effect = i 
Click Events and drag awhen flag clicked = 
block to the scripts area. Choose the Control tab = 
and add a forever block below when flag clicked. ans 
Within the More Blocks menu, find the set pixel = 
block and drag it inside the forever block. A Step 3 Creating a random sparkle effect 
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magpi.cc/Nqwqmz 


The Sense HAT has 
64 LED lights (in 

an 8x8 matrix) that 
can be set to any 
RGB colour. We're 
using them to scroll 
text and create a 
disco effect 


Top Tip 


Analogue audio 


If you're using 
headphones or 
speakers, don't 
forget to change 
the audio out on 
your Raspberry 
Pi from HDMI to 
Analog. Right- 
click on the 
volume icon on 
the desktop. 
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> Step 4 Find 
some music 


WV Step 5 Import 
the MP3 files 
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With the pick random block (under Operators), 
you can set random pixel positions and random 
colours within the loop to make your Sense HAT 
sparkle, by choosing LEDs on the Sense HAT to 
light up (numbers between 0 and 7 on the 8x8 
erid), and the amount of red, green, and blue to 
colour the pixels (numbers between 0 and 255). 

Have a go at running your program by clicking 
on the green flag. You should see the LEDs on the 
Sense HAT begin to randomly sparkle. 


Get some tunes 

Now you have a disco effect, it’s time to 
make your MP3 player play some tunes! First, 
save the project. Back in Scratch, click File > Save 
Project > Create Folder. Name the folder Scratch 
MP3 and double-click it to navigate inside. Name 
the file Scratch MP3 Player.sb2 and click Save. 


M |t's time to make your MP3 
player play some tunes @ 


Gather a few MP3 files together to begin with 
— you'll want at least three. (We’ve downloaded 
three tracks from freemusicarchive.org). Save 
them in the same Scratch MP3 directory as your 
Scratch code. 


Add the sounds 
Click on the Sounds tab for your sprite. Get 
rid of all the stock sounds, such as ‘scratchy beat’ 
and ‘drum jam’ (right-click and select Delete). 
Now use the ‘Upload sound from file’ button to 
upload all your MP3 files. Choose the MP3 files in 
your Scratch MP3 folder and click Open. 


Face the music 

Now it’s time to play your tracks. Your code 
should currently look like that in Step 03. You can 
play a sound using the play sound block. Add this 
block above the forever loop. 

Click on the green flag to play your track as the 

disco lights start. Make sure you have speakers or 
headphones plugged into your Raspberry Pi. 


07 Analogue out 
At this point you will need to change the 
sound output to analogue by right-clicking on the 
speaker icon in the header bar of the desktop and 
then clicking the Analog option. 

Next, you’re going to display the number of the 
track that’s currently playing. Click on Data and 
Make a Variable; call it ‘track’ (leave it set for all 
sprites and click OK). 


Set track 
Drag a set block above your play sound 
block and choose track and 1. Click More Blocks 
and drag a scroll message block under set track. 
The scroll message block can use the track 
variable with a join block. Drag a join block and 


V_ Step 8 Scroll the track number on the LED matrix 
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V_ Step 9 Controlling volume with the joystick 
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enter ‘track’ in the left field, and drag a track 
variable into the right field (as shown in the 
image). You can choose whichever colours you like. 


Volume control 
You can now add some extra controls to your 
MP3 player. First of all, set up your script so that 
the Sense HAT joystick can control the volume. 
Raspberry Pi treats the Sense HAT joystick in 
the same way as the arrow keys on your keyboard. 
This means that, for example, pushing the 
joystick up is the same as pushing the up arrow 
on your keyboard. 
Test your scripts again: click the green flag, and 
then use the Sense HAT joystick to change the 
volume of your music. 


Change tracks 

Now that you know how to use the joystick, 
it’s time to try to use it to change which track is 
playing. When the program starts, you will need to 
stop all sounds. 

Use the when left arrow is pressed and the 
when right arrow is pressed blocks to stop all 
sounds and to increase or decrease the value of your 
track variable. 

You can also use a scroll message block to show 
again which track is being played. You can use the 
when arrow is pressed blocks to change the value 
stored in your track variable. 

That’s it - your MP3 player is complete! Click on 
the green flag and then have a go at changing your 
tracks using the Sense HAT joystick. Hl 
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TopTip @ 
Shuffle 


A nice feature 

to have on an 
MP3 player is the 
option to shuffle 
the tracks so 

that they play in 

a random order. 
Pushing the Sense 
HAT joystick 
inwards means 
the same thing 

to Scratch as 
pressing ENTER 
on the keyboard. 
Update the MP3 
player code so 
that when the 
joystick is pushed, 
the code chooses 
and plays a 
random track. 





VW The Sense HAT is 
a versatile piece of 
hardware made by 
Raspberry Pi. It's 
called a Sense HAT 
due to all the sensors 
on board (hardware 
and motion), but 
we're using its other 
features here 
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Add vision with the 


A Raspberry Pi Camera Module should be an essential 
piece of any digital maker's kit, as it can be used In a wide 
variety of projects. Wesley Archer puts us in the picture 


ive your Raspberry Pi the gift of sight We’ve seen many exciting builds take advantage 
G with an official Camera Module of these, but being able to see what is happening 
(magpi.cc/xSXqyL). This handy add-on around your Raspberry Pi is very simple with 
connects directly to the Raspberry Pi and is used the Camera Module. These are some of the best 
in a wide range of vision-based projects. projects for beginners. They’re easy to set up and 
Using a Raspberry Pi to monitor its produce visible results. 
surroundings is a fascinating subject, especially Using the Camera Module is a great way to 
with the huge array of sensors, accessories, HATs, addan extra dimension to most projects. Let’s 
and pHATs available. get started... 


Reg ular or w Camera Module V2.1 w Camera Module NolR V2.1 


alcelalmusrcicel are 





The Camera Module has two 
variants — the standard version 
and the NolR version, which 
has the infrared filter removed 
to allow the camera to detect 
infrared light. It makes a great 
night-vision camera when used 
with an IR light source! 
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The Camera Module is small The small lens captures still 
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SETUP YOUR ~ 
CAMERA MODUL 


Before you can start snapping away with the Camera Moat 
you ll need to connect it to a Raspberry Pi and test it out 








You'll Need 


> Raspberry Pl 
Camera Module 
magpi.cc/ 
kAtsHn 


> Pi Zero Camera 
Adapter (optional) 
magpi.cc/ 
uAUbdp 


> microSD card 


> Raspbian 


Disable LED 


The Vi Camera 
Module lights a 
red LED when 
activated (the V2 
Camera doesn't 
have one). To 
disable this, add 
disable camera_ 
led=1 to the 
/boot/config.txt 
file (and reboot). 


> While small, the 
Camera Module takes 
high-resolution photos 
(up to 3280x2464 pixels) 
and captures HD video 
(up to 1080p) without 
breaking a sweat 





etting up a Camera Module couldn’t be 
easier. You attach the Camera Module 
directly to the Camera Serial Interface (CSI) 
port on the Raspberry Pi board. 

Connecting it to your Raspberry Pi is the same 
whether you own a Raspberry Pi 3A+/3B+, 4, Zero, 
or even an earlier Model B with 26 GPIO pins. 

However, if you are going to connect a Camera 
Module to a Raspberry Pi Zero (1.3, W, or WH), 
you’ ll need to use a Pi Zero Camera Adapter. This is 
often sold separately (£4, magpi.cc/uAUbdp), and 
sometimes included with the Official Raspberry Pi 
Zero case (magpi.cc/LECcmF). 

If you received a Raspberry Pi Zero W free 
with a12-month subscription to The MagPi 

(magpi.cc/subscribe), you will have got a Zero 
Camera Adapter cable free with your Starter Kit. 

Once you’ve got your Camera Module and 
Raspberry Pi, you use the cable to attach the two 
together. We’ll show you how... 


S 


Connect the cable to 

a Raspberry Pi 2/3/3+*/4 
On a full-size Raspberry Pi, you will need to 
connect the camera cable to the Camera port 
nearest the Ethernet port. Gently lift the small 
plastic clasp on the Camera port and connect the 
camera cable with the blue part facing towards 
the Ethernet port, then gently push the clasp back 
down so it holds the cable in place. 


Connect the cable 

to a Raspberry Pi Zero W 
The Raspberry Pi Zero W has a smaller Camera 
port, but the official Raspberry Pi Zero case usually 
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includes the cable. As with a full-size Raspberry 

Pi, gently pull the plastic clasp and then slot the 
camera cable in — you should see the white part 
facing upwards. You’1] know if the cable is in 
correctly if the camera works, but it is best to check 
before booting your Raspberry Pi. 


Connect the 

Camera Module 
Similar to the way the camera cable connects to 
Raspberry Pi, gently pull the small plastic clasp on 
the Camera Module and then slot the other end of 
the camera cable into the port — this time the blue 
part should be facing you, with the camera lens 
pointing the opposite direction. Gently close the 
clasp, locking the cable in place — the clasps can be 
fragile, so handle with care. 
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Bial=mer-|0)(=mere)al al-veins 
the Camera Module to 
al=m@t-laal=1e-M ole) amelalre| 
Raspberry Pi board 





A Raspberry Pi Zero 
owners will need a Pi 
Zero Camera Adapter 

to connect the Camera 


Mi al=mor-lo) (<M om i(=>.do)(-mm-larelolilare BVole xem ele-tin(ola Module to the smaller 
Camera socket on 
rel alo -\nmo\olamdal-mOr-|aal-1¢-M Lele (UIK-MNdal-1c-\.-1 Mel 6] theboard 


W(/-Va] mu xe) vce] 0 lao) ce) (-reimm (olUmer-lal-lom olU\Mellik=1c-10) te 
length cables to suit your project 





Enable the Camera Module Enabling via SSH Raspberry Pi 
By default, the Camera Module is not enabled If you are accessing your Raspberry Pi over OF eal =) gsm Ors X= 
in Raspbian, but it is very easy to do this. If you SSH, you’ ll need to enable the camera via the 
have your Raspberry Pi connected to a mouse, command-line Raspberry Pi configuration tool lig) Use 
keyboard, and monitor, you can use the Raspberry instead. Enter the following in a Terminal window: AES eles te) 
; not buy a Raspberry 
Pi Desktop to enable the Camera function. Click pj 
i case designed to 
on the raspberry icon (top left) and choose sudo raspi-config area tenia 
Preferences > Raspberry Pi Configuration. Click the Camera Module, 
Interfaces tab and set Camera to Enabled. Click Ok; Now select ‘5 — Interfacing Options > P1 - Camera’ such as the PiShell? 
when prompted to reboot, click Yes. and choose <Yes> to enable the camera. Press 


ENTER on <Ok> and choose <Finish>. When 
asked to reboot, choose <Yes>. We’re now Set to 
snap away. 












System | Intefaces | Performance | Localisation 
Camera *) Enabled Disabled 
} SSH *) Enabled Disabled 
= | eee Test the Camera Module 
VNC Enabled *) Disabled mar . : . : 
ao Before diving into a project, it’s worth testing 










Enabled ) Disabled 


your Camera Module works as expected first. Open 
a Terminal and enter this command: 





Enabled Disabled 










Dizabled 





Enabled 


Enabled Disabled raspistill -o /home/pi/hello. jpg 















Enabled *) Disahled 





Remote GPO 





Smile for a few seconds — you can see yourself on | 
4 You must activate 
the live camera preview — while the photo is taken the Camera interface 
s di in Raspberry Pi 
and saved to the /home/pi directory. Why not open Pangan oa ceice 
it in File Manager to see the results? using the camera 
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CAMERA MODUI 
SETTINGS 


Get the most out of your Camera Module by tweaking 
the various settings and creating different effects 





he Camera Module doesn’t just snap photos 
— it also records video — but did you know 

that there are lots of different settings that 
can be applied to customise how the photo or video 
appears? In this guide, we’re going to explore some 
of the settings and commands that can be used 
to tailor how you use the Camera Module in your 
project, and we’ll explore some of the more quirky 
features too! 





1 Adjusting resolution 

and brightness 

The v2.1 Camera Module has a maximum resolution 
for a photo of 3280x2464 pixels, but images 

this large can take up a lot of storage space over 
time and take longer to process by Raspberry Pi. 
Fortunately, raspistill, the program that captures 
photos on our Raspberry Pi, allows us to specify 
the photo resolution very easily. For example, 

you can set the width (640 pixels) and height (480 
pixels) using the -w and -h parameters accordingly. 
You can also specify the brightness with the -br 
parameter and a value between 0 and 100. The 
image above was taken with the NoIR Camera 
Module (hence the odd colours) using: 
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raspistill -w 640 -h 480 -br 4@ -o /home/ 
pi/hello. jpg 


This demonstrates how you can take a smaller 
photo (640x480 pixels) with a brightness of 40, but 
feel free to experiment to see what works best. 


nd 


0950.03 


2 Adding text 


If you’re old enough to remember actual 
printed photographs, then you may have noticed 
that some cameras added the date and time 
to record when the photo was taken. If you’re 
too young to remember, don’t worry as you’ve 
just learned something new! With raspistill 
you can add your own text to your photos too, 
using the -a or --annotate parameter. Take the 
following example: 


raspistill -a 4 -a "Pi Camera %d-%m-%Y 
*X" -o /home/pi/text. jpg 


The first -a 4 part sets the bitmask notation in 
the metadata to record the time (more info on that 
here: magpi.cc/2egcYup). 

The second -a part includes our custom text 
(Pi Camera) and formats the date into dd-mm-yy 
(%d-%m-%Y) before adding the time (%X) and then 
saving the photo in our Raspberry Pi’s home 
directory (/home/pi) as text.jpg. 





“You can add image effects to photos taken 
by the Camera Module, such as inverting the 
colours to a negative" 


Add image effects 

Another quirky feature of raspistill is that 
you can add image effects to photos taken by the 
Camera Module, such as inverting the colours toa 
negative, making the photo look like a sketch, or 
even adding a cartoon effect. Now, before you all 
get carried away, some of the effects can be a little 
hit-and-miss, but they can add a cool look to your 
photos nonetheless! This is done by adding the 
-ifx parameter along with the desired effect (full 
breakdown available here: magpi.cc/SuuECJ). 

The following example applies a negative effect 

to the photo, as well as adding our custom text, 
date, and time: 


raspistill -ifx negative -a 4 -a "Pi 
Camera %d-%m-%Y %“X" -o /home/pi/negative. 
jpg 


As you can see from the image above, this is an 
interesting effect! Be sure to try out the sketch and 
emboss commands too. 








We've only just 
scratched the 
surface of what 
the Camera 
Module can do 

in our guide, so 
why not take 

a look at The 
MagPi Essentials 
Camera Module 
Guide for amore 
comprehensive 
overview of all the 
commands, hints, 
and tips to ensure 
you get the most 
out of it? 


i 
CAMERA 
MODULE | 


GUIDE 





Make the photo 
look like a watercolour 
painting instead of a 
negative with the -ifx 
watercolour parameter 


Embossing is the 
process of creating a 
raised image, usually 
in paper or card. You 
can recreate the effect 
with the -ifx emboss 
parameter 
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CAMERA MODUL 
PROJECTS ( 


We've selected six Camera Module-related projects to try out 
If you need some inspiration, then take a look at the pick of the 










Stop-motion animation 

Stop-motion animation — think Wallace & 
Gromit — is where a series of photographs are 
taken, but with minor changes made to the 
‘scene’ being filmed. The scene is changed 
slightly between shots — known as frames — 
and when they are all stitched back together 
afterwards, the illusion of animation is 
complete! In this fantastic tutorial, learn how to 
add a button to your Camera Module setup and 
create your very own stop-motion animation! 
More info: magpi.cc/KiYbdb 





Raspberry Pi Zero LED case hack 

As you now know, the NolIR version of the 
Camera Module has the infrared filter removed 
from the lens so that it can detect infrared light. 
This makes it an ideal choice for projects in the 
dark. In this neat project, you can easily add IR 
LEDs to provide additional infrared light, so that 
your pictures capture more detail in the dark - 
and all housed within the official Raspberry Pi 
Zero case, too! 

More info: magpi.cc/xCozST 


Rodak: a Raspberry Pi in aq Kodak 
Taking photos is what the Camera Module is 
designed for, so what better way to do that than 
to upcycle an old Kodak Brownie Flash III camera 
to house a Raspberry Pi Zero, like Alex Ellis did? It 
also contains some additional components, such 
as a LiPo battery for power-on-the-go, a push- 
button to trigger the camera, and a cool NeoPixel 
status LED to show you when the camera is ready 
to fire again! 

More info: magpi.cc/sAxjyc 
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Google Vision: Camera Tell 

This cool project, by Dan Aldred (aka TeCoEd), 
makes use of the Google Vision cloud service. If you 
haven’t heard of Google Vision, it uses artificial 
intelligence to analyse an image and tells you 

what is in it! Dan takes this project even further by 
creating a portable camera — housed inside an old 
disposable camera — that uses a Camera Module, 

as well as Google Vision to announce what you have 
just taken a photo of. 





Home CCTV with motionEye0S 

If you missed the Home Security feature in The 
MagPi 73 (magpi.cc/73), you should definitely 
check out the handy motionEyeOS, which is 

a Standalone operating system that runs on 
Raspberry Pi and allows you to easily create your 
very own home CCTV setup with a few clicks. Once 
the OS image is flashed to your microSD card, you 
will be up and running in no time and be able to 
keep an eye on your home when you are away. 
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Make a parent detector 

Do you suspect your parents sneak into your 
room when you’re out? Do they play on your 
Xbox or PS4 without your permission? Then 
follow this tutorial and build a parent detector, 
using the Camera Module and a PIR (passive 
infrared) sensor, and catch them red-handed! 
Learn how the PIR sensor can trigger the Camera 
Module to take a photo whenever it detects 
movement, then see how your parents react 
when confronted ade me suilence: 
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Dave 
Honess 





Dave lives in 

the Netherlands 
and works at 

the European 
Space Research 
and Technology 
Centre, where he 
helps coordinate 
the educational 
operations for 
European crew on 
the ISS. 


@dave_spice 


You'll Need 


> Raspberry Pi 2B or 
later 


> 3.4mm speakers or 
headphones 


>» RTL-SDR USB 
dongle (search for 
‘RTL2832U)) with a 
good whip or dipole 
antenna (or just 
get this starter kit: 
magpi.cc/UuBMKQg) 


> Tape measure, at 
least 1 metre 








Pictures from space 
via ham radio 


Have you ever wanted to receive a radio signal from space? 
It's fun and a lot easier than you might think! 


hat is Slow Scan TV (SSTV), then? You 
W convert a picture into sound (similar to 

fax machine or dial-up modem noise) 
transmit the sound via radio, and convert the 
received sound back into a picture at the other 
end. The International Space Station (ISS) has 
a long history of transmitting SSTV pictures for 
global events, each lasting several days, where 
people the world over tune their radios to the ISS 
and try to receive the pictures every time it flies 
over their home. It’s a hobby of mine! 

One such event began on 12 April 2019 to 
celebrate the anniversary — to the day - of the 
launches of Yuri Gagarin in 1961 and the first 
Space Shuttle, 20 years later, in 1981. 


Install prerequisites 

and set the time 
We presume you are running a clean install of 
Raspbian and are online. 


NASA On The Air 
Apollo 16 
Bia 


OS 





A This is one of the clearest pictures your author has been able 





to receive with this setup. It was from an 83 degree elevation 
pass near Amsterdam, in the Netherlands, on 15 February 2019 
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Firstly, switch the audio output to the 3.5mm 
headphone jack. This is needed for the way 
PulseAudio loops back the system audio as an 
input device. On the Raspbian desktop, simply 
right-click the speaker icon in the menu bar and 
choose Analog. 

Then, open a Terminal and install the required 
software for the project: 


sudo apt-get update 
sudo apt-get install rtl-sdr sox 
pulseaudio qsstv ntpdate -y 


Next, set your time zone and pull the correct time 
from the internet. In the Raspbian main menu, 
eo to Preferences > Raspberry Pi Configuration > 
Localisation tab > Set Timezone, change Area and 
Location accordingly, then click OK. 

Finally, go back to the Terminal window to pull 
the time: 


sudo ntpdate pool.ntp.org 


Note that the desktop clock in the top right only 
updates every minute. 


Install and test 

the RTL-SDR dongle 

Insert the RTL-SDR dongle into your Pi and screw 
in the antenna (it can sit on your desk at this 
stage). Then verify the RTL-SDR is working with 
the rtl_test program. In a Terminal window, enter: 





rtl_test 


If you see a ‘failed to open rtlsdr device’ error, 
remove the dongle, reinsert it, and try rtl_test 
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This inexpensive 
USB dongle acts as 
the radio receiver 








A |t takes about two whole minutes for a picture to be decoded. 
When they do this from the ISS, a picture is transmitted 
continuously for about two minutes, with two minutes of 
off-time before the next picture starts 





again. Leave for about 30 seconds and look out for 
any messages about loss of samples. Press CTRL+C 
when 30 seconds has elapsed. The loss of 100 bytes 
or so is acceptable. 


Listen to ag commercial 

FM radio station 
Let’s tune into acommercial FM radio station to 
check that both the dongle and the antenna are 
working correctly. The command below pipes 
raw data from rtl_fm into ‘play’, which will then 
produce the audio output. Modify the value after 
the -f to specify your own FM station/frequency 
and don’t forget to put the capital M after the 
number so it knows you mean megahertz and not 
hertz (98.8MHz is BBC Radio 1 in the UK). Ina 
Terminal, enter: 


rtl_fm -M wofm -f 98.8M | play -r 32k -t 
raw -e s -b 16 -c 1 -V1 - 


Note that the ‘Tuned to’ value in the output 
doesn’t match. This is due to a property of all 
SDR hardware, called ‘DC spike’, and can be 
ignored. Plug in your speakers/headphones and 
you should now be able to hear audio from the 
commercial FM station. Move the antenna around 
or select a different FM radio station with a closer 
transmitter if the audio is noisy. Press CTRL+C to 
quit from rtl_fm. 


Set up QSSTV 

QSSTV is the program that will listen to 
the audio output on the Raspberry Pi and decode 
the pictures from the fax/modem noise when the 


Bi alcmice- Me leleronmolels 
‘ot al=v-\ emus al k=val ale! 

Nal (ola ers lam e)(oL@ele) 
the ISS SSTV signal 


ISS is in range. Let’s just check the settings are all 
correct. In the main menu, select Internet > QSSTV, 
then select Options > Configuration and choose the 
following options in the Sound tab: 


Audio Interface — PulseAudio 

Input and Output Audio Device - default -- Playback/ 
recording through the PulseAudio sound server 
Sound Input — From sound card 

Sound Output — To sound card 


Click OK. Next, run the Calibrate function and go 
make a cup of tea/coffee: Options > Calibrate. Click 
OK when both progress bars reach 99%. 


Decode a picture from test audio 

Now that QSSTV is set up, we can download 
a test audio file, play it, and see a picture slowly 
appear. In a Terminal, enter: 


wget https://raw.githubusercontent.com/ 
davidhoness/sstv_decoder/master/sstv_test.mp3 


Select the Receive tab in QSSTV and choose the 
following settings: 


Use VIS - on 
Auto Slant — on 
Autosave — on 
Signals — Normal 
Mode - Auto 








TopTip & 


Play with SSTV 
on mobile 


For a quick test, 
you can try these 
free mobile 

apps: Robot36 on 
Android; CQ SSTV 
on iOS. Play this 
MP3 (magpi.cc/ 
ruANWC) and put 
the phone near 
the speaker. 
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RTL-SDR 
Starter kit 


Your author 
personally 
recommends 

this starter kit 

that comes with 
the USB dongle 
and a good 
v-dipole antenna: 
magpi.cc/ UBMKQg 


Imagine holding this 
picture above your 
head and aligning 

it with the compass 
directions. The line 
shows the flight path 
of the ISS across the 
sky above you 





Click the play ® button. Nothing will happen, but 
just click it to start the receiver. 

Open sstv_test.mp3 in the Chromium browser. 
You can either drag and drop the file from File 
Manager, or enter file:///home/pi/sstv_test.mp3 
into the address bar. 

Let it play and watch the picture appear in QSSTV. 
Notice the waveform and waterfall display activity on 
the right of the screen. Other SSTV test recordings 
can be found online, such as: magpi.cc/dXpjRr. 


Prepare for the next SSTV event 
To get pictures from the ISS you need to 
know three things: 


- When the ISS will be transmitting the SSTV 
signal. It’s not always-on. 

- What frequency the SSTV signal will be 
transmitted on (usually 145.8MHz). 

- When the ISS will fly over your location. 


The ISS flies over most places a few times every 
day (unless you live in the Arctic/Antarctic). You 
can find out when the ISS is transmitting on this 
website: ariss-sstv.blogspot.com. 





vet 
peek 
pect 
eerie 
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At the time of writing, for instance, an SSTV 
event was scheduled to start on 4 August 2019 
to honour NASA astronaut Owen Garriott, the 
first person to operate amateur radio from space. 
These events usually last for a few days at a time, 
meaning you will get multiple ISS passes during 
which you can receive the SSTV signal. 


07 When is the ISS flying over me? 
There are many websites you can use 

for this, but your author’s personal favourite 

is heavens-above.com. 

Click ‘Unspecified’ in the top right to set your 
location. Type your postal code and country into 
‘Enter place to search for’ and click Search. Scroll 
down and click Update. You’1l now be back on the 
homepage; under Satellites, click ISS. For ‘Passes 
to include’, select ‘all’. 

The table now showing lists the times of the 
upcoming ISS passes for your location. The Alt 
value under ‘Highest point’ is the maximum 
elevation of the pass above the horizon; 90 would 
mean it goes directly overhead. Passes with higher 
maximum elevation will give better results than 
lower ones. Clicking on any row in the table shows 
the sky chart for that pass. Imagine holding that 
picture above your head and aligning it with the 
compass directions. The line shows the flight path 
of the ISS and this is useful for roughly positioning 
your antenna. It can also be useful to look at the 
‘Ground track’ (see link in top right). Plan ahead 
and set up your ground station with time to spare 
before the ISS flies over. 





Adjust your antenna 

If you are using the RTL-SDR kit 
antenna, please read the getting started guide for 
it: Magpi.cc/qzUKtZ. 

It’s a good idea to adjust the length of the 
telescopic arms based on this dipole calculator 
(magpi.cc/uGNNxP) to match the antenna’s 
resonant frequency to 145.8MHz. This will help 
pick up weaker signals from low elevation passes. 

Under Desired Frequency, enter 145.8. Under 
Select Antenna Calculation, select One Side. Click 
Calculate. The answer should be 48.9cm. 

Remember, there is about 2cm of metal in each 
side of the antenna base. So take 48.9 and, before 
screwing in the arms, use a tape measure to make 
them both this length minus 2cm (excluding the 


screw threads). It doesn’t have to be perfect, but 
make it as close as possible. 


Deploy your antenna 

As a general rule, try to get your antenna 
up as high as possible with a good view of the 
sky in all directions. Outside is always better, but 
you can Still get the signal from inside a house - 
you’ll just see more noise in the pictures. Then, 
with the dipole arms flat, roughly align them 
with the flight path of the ISS that you find on 
heavens-above.com and bend the two arms 
upwards into a right-angle V-shape. You don’t 
need to realign it for every pass, but it will yield 
better results if you do. 

Antennas and their performance are sometimes 

a bit of an art form as opposed to an exact science. 
Experiment with different configurations on 
different ISS passes. Try one arm horizontal and 
one arm vertical, for instance. 


Set the correct time again 

QSSTV saves the decoded images with a 
UTC time file name and this is useful later when 
working out which ISS passes they are from. Ina 
Terminal, enter: 


sudo ntpdate pool.ntp.org 


Tune into the ISS frequency 

We’ ll use rtl_fm again for this, but note that 
the command is different to the commercial radio 
Station one. Acommercial radio station uses wide 
band FM whereas the ISS SSTV transmission uses 
narrow band FM and so we have to set rtl_fm up 
differently. In a Terminal, enter: 


rtl_fm -M fm -f 145.8M -s 48k | play -r 
48k -t raw -e s -b 16 -c 1 -V1 - 


You should be able to hear white noise now (don’t 
forget the capital M for megahertz), but this will 
change to the fax/modem noise when the ISS 
flies over with the transmission active. Keep this 
window open. A picture is transmitted from the 
ISS continuously for about two minutes, with 
another two minutes of off-time before the next 
picture starts. 
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Start QSSTV 

In the Raspbian main menu, select Internet 
> OSSTV. Select the Receive tab in QSSTV and 
choose the following settings: 

Use VIS - on 

Auto Slant — on 

Autosave —- on 

Mode - Auto 

Save if Complete (%) — 10 


Click the play » button. The waveform and 
waterfall display on the right should show noise 
coming from rtl_fm. Leave QSSTV running. 


The ARISS VHF 
antenna installed on 
the bottom of the 
Columbus module 
Credit: NASA/ESA 


fm Antennas and their performance are 
sometimes a bit of an art form as opposed 


to an exact science @ 


What ts Doppler shift? 


A common example of Doppler shift is 

the change of pitch heard when a police car or 
ambulance speeds past you. Compared to the 
emitted frequency of the siren, the frequency you 
hear is higher during the approach, identical at the 
instant of passing by, and lower during departure. 
The same thing happens with radio waves as with 
sound waves. The ISS is moving at 7 km per second! 

To compensate for this, ground stations must 
continually retune their receiver as the ISS 
approaches (starting ~3.5kHz above 145.8MHz), 
passes overhead (reaching 145.8MHz exactly), 
and flies away (ending ~3.5kHz below 145.8MHz). 
The good news is that QSSTV is clever and can 
compensate by tracking the centre frequency of the 
audio signal as the ISS flies over. So you don’t need 
to do anything! 
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Antennas 
to avoid 


Avoid the little 
30cm mag- 
mount antennas 
that often come 
with these RTL- 
SDR dongles. 
You will have 
little or no hope 
of picking up the 
ISS with them. 


Get Started With Raspberry Pi @ | 75 


Ms TUTORIAL 


a t 2 Belli Suite] 5 i Reh BA 
| [ObArEeh CHD: p20H0 Ka GopTy Beye 
a PTE er] 


Durad Homwevn Wee T 


Baad LAT el agp creer rain adie De NR Se Be al WB rey Bae Balt 
em ae ed og ee, SE Td a ee ad es Oe ee 
Ngan or Soa 





SHEPTHG ? & Qo = 





A You can potentially get a certificate like this, even if you only 
decode a few lines of one picture 








Compensate for 

Doppler shift (optional) 

It doesn’t make much difference, but if you 
want to have some fun with this, your author 
has created a Python script to compensate for 
Doppler shift. It tracks the ISS using ephem, 
computes the corrected frequency for when the 
ISS is passing over, and retunes rtl_fm using a 
UDP socket: magpi.cc/zNtRDB. 

To use it you’ll first need to run sudo pip3 
install ephem and then just start the script 
in another Terminal window. But first you will 
need to modify the code to set your location. 
See the LATITUDE, LONGITUDE, and ALTITUDE 
variables at the top. Get the values from the top 
right of heavens-above.com and just estimate 
your altitude. 





Wait for the ISS to arrive 

You may want to leave your ground station 
overnight or over the weekend to capture several 
passes. When you return, select the Gallery tab 
in QSSTV to see what images were received. 
Alternatively, it’s always exciting to watch the 
pictures coming in live as the ISS is above you! 


Get an SSTV award! 


On your Raspberry Pi, the decoded pictures 
can be found in /home/pi/qsstv/rx_sstv. You can 
upload them on this website for verification and 
recognition: magpi.cc/Kdjnmy. 

Check the information for the event on 
ariss-sstv.blogspot.com to find out how to apply 
for the award certificates. This will be a PNG file 
that is emailed to you and will show a unique 
number. Good luck! 
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doppler.py 


> Language: Python 


0e1. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
99. 
010. 
Q11. 
Q12. 
013. 
014. 
Q15. 
916. 
017. 
018. 
919. 
920. 
Q21. 
Q22. 
Q23. 
Q24. 
Q25. 


Q26. 
Q27. 
028. 
Q29. 
930. 
931. 
932. 
933. 
934. 
Q35. 
036. 


Q37. 
038. 
939. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 


#! /usr/bin/python3 
import urllib.request 
import math 

import socket 

import ephem 

import time 

import sys 

import ssl 


C = 300000000.0 
F@ = 145800000 .0 


LATITUDE = "52.219308" 
LONGITUDE = "4.419926" 
ALTITUDE = 20 


class tle _reader(object): 


For keeping ephem two line element sets up to date 
def _init_ (self, 
tle _name="ISS (ZARYA)", 
tle file= 
"https: //celestrak.com/NORAD/elements/stations.txt", 
tle_max_age=36@0) : 
self. tle name = tle name 
self. tle file = tle file 
self. tle _max_age = tle _max_age 
self. tle = None 
self.reload() 


def build _index(self, tle lines): 
index = {} 
for i in range(@, len(tle_lines), 3): 
index[tle lines[i].strip()] = (tle_lines[i + 
1], tle_lines[i + 2]) 
return index 


def reload(self): 
print("Loading: %s" % self. tle file) 


try: 
ctx = ssl.create_default_context() 
ctx.check_hostname = False 
ctx.verify_mode = ssl.CERT_NONE 
with urllib.request.urlopen(self. tle file, 
context=ctx) as response: 


Q47. 


048. 
Q49. 
Q50. 


Q51. 
Q52. 
953. 
Q54. 
Q55. 
Q56. 
Q57. 
058. 
Q59. 
060. 
061. 
062. 


063. 
064. 
065. 
066. 
067. 
068. 
069. 
970. 
Q71. 
Q72. 
973. 
074. 


Q75. 
076. 
077. 
078. 
979. 
080. 
081. 
082. 
083. 
0384. 
085. 
086. 
087. 
088. 
089. 
990. 
991. 


tle lines = response.read().decode( 

"“utf-8").splitlines() 

index = self.build_ index(tle_ lines) 

tle data = index[self. tle name] 

self. tle = ephem.readtle( 
self. tle name, tle data[0], tle data[1i]) 

except Exception as e: 
print(e) 


self. tle age = time.time() 


@property 
def tle(self): 
return self. tle 


@property 
def tle expired(self): 
return time.time() - self. tle age > 
self. tle _max_age 


class rtl_fm_remote(object): 


For remote control of rtl_fm command line program 
def _init_ (self, 
host="localhost", 
port=6020): 
self. host = host 
self. port = port 
self. s = socket.socket( 
socket.AF_INET, socket.SOCK_DGRAM) 
self. s.connect((self. host, self. port)) 


def set_freq(self, freq): 
self.send_cmd(@, freq) 


def set_mode(self, mode): 
self.send_cmd(1, mode) 


def set_squelch(self, squelch): 
self.send_cmd(2, squelch) 


def set_gain(self, gain): 
self.send_cmd(3, gain) 


def send_cmd(self, cmd, param): 
cmd_bytes = (cmd).to_bytes(1, "“little") 
param_bytes = (param).to_bytes(32, "“little") 


992. 
993. 
994. 
995. 
096. 
097. 
098. 
O99. 


100. 
101. 
102. 
103. 
104. 
105. 
106. 
107. 
108. 
109. 
1te. 
111. 
112. 
113. 
114. 


115. 
116. 
117. 
118. 
119. 


120. 
i271. 


122. 


123 
124. 
125. 


126. 
127 


128. 
129; 
130. 
131. 
132. 
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THE FULL CODE: 


yy) magpi.cc/ZNtRDB 


self. _s.send(cmd_bytes + param_bytes) 






def _del_ (self): 
self. s.close() 


rtl = rtl_fm_remote() 
iss = tle reader( 
tle _name="ISS (ZARYA)", tle_max_age=5520) 


if iss.tle is None: 
sys.exit(@) 


myloc = ephem.Observer() 
myloc.lon = LONGITUDE 
myloc.lat = LATITUDE 
myloc.elevation = ALTITUDE 


freq = Fe 
running = True 


Try: 
while running: 
myloc.date = time.strftime( 
"PY /hn/*d ZH:%M:%S', time. gmtime() ) 
iss.tle.compute(myloc) 
alt = math.degrees(iss.tle.alt) 


if alt > @: # iss is flying over location 
new_freg = int( 
F@ - iss.tle.range velocity * F@ / C) # doppler 
if new_freq != freq: 
print( 
new_freg, round(alt, 2), myloc.date) 
rtl.set_freq(new_freq) # set new 
frequency in rtl_fm 
freq = new_freq 
elif iss.tle expired: 
iss.reload() # we could be running for 
days / weeks 
else: 
time.sleep(10) # do nothing, wait for 
iss to arrive 
freq = FO 
except Keyboardinterrupt: 
running = False 


print("Bye") 
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All Raspberry Pi models have a 

03} si out port to connect 
analogue devices. Model B+ and later 
combine the audio out and composite 
out on to the same 3.5mm jack plug. 
This requires a particular type of lead, 
with audio left on the tip, audio right 
on ring 1, ground on ring 2, and video 
on the sleeve. See magpi.cc/tDfjLV. 


en 


The HDMI port outputs audio 

as well as video. If your display 
lacks a built-in speaker, you’1l want 
to use the speaker jack. If so, right- 
click on the volume icon in the menu 
bar and switch from HDMI to Analog. 
Alternatively, use the command line: 


ie 


amixer cset numid=3 1 
Set the last number to ‘1’ for Analog, 
or ‘2’ for HDMI. Use raspi-config to 
change the audio setting at boot: 


sudo raspi-config 


Choose Advanced Options > Audio and 
‘Force 3.5mm (‘headphone’) jack’ or 


‘Force HDMI’ to set this as the default. 


The power requirements of your 
Raspberry Pi increase as you 
make use of the various interfaces. 
The GPIO pins can draw 50 mA Safely, 
distributed across all the pins; an 
individual GPIO pin can only safely 
draw 16mA. The HDMI port uses 

50 mA, the Camera Module requires 
250 mA, and keyboards and mice can 
take as little as 100 mA or quite a bit 
more. Buy the Official Power Supply 
and check the power rating of your 
devices: magpi.cc/xfszUR. 


You can use a webcam, but 
Raspberry Pi has a dedicated 
option: the Camera Module 
(magpi.cc/jbKzbf). This is attached 
to the CSI (Camera Serial Interface). 
The Camera Module is used to take 
high-definition video and still 
images. It’s easy to use for beginners, 
but has plenty to offer advanced 
users if you’re looking to expand 
your knowledge. There are lots of 
examples online of people using it for 
time-lapse, slow-motion, and other 
video cleverness. You can also use the 
libraries Raspberry Pi has developed 
to create visual effects. 


















A Raspberry Pi Touch Display 
(magpi.cc/CAPxtI) gives users 
Lie avility To ereate all-in-one, 
integrated projects such as tablets, 
infotainment systems, and embedded 
projects. Its ribbon cable connects to 
the DSI port present on all Raspberry 
Pi boards (except Raspberry Pi Zero 
and Zero W). 













Open a Terminal and enter: 
pinout 


...for a quick visual guide to the GPIO 
pins. Or enter: 


pinout -x 


...to open the web browser and point it 
to the interactive model at pinout.xyz. 


You can see the mechanical 
drawings for Raspberry 

Pi 3B+ (and all other models) 

on the Raspberry Pi website: 
magpi.cc/WWFUji. 


Many Raspberry Pi models 
feature a wireless LAN adapter 

to connect to local network. But you 
can also use the access point to create 
a wireless hotspot. The process is a 
little long, but it’s great for learning 
more about how wireless LAN works. 
Read more at magpi.cc/nnriRT. 


Get Started with Raspberry Pi & 79 











cd /opt/vc/src/hello pi 


./rebuild.sh 


cd hello _tiger 
./hello_tiger.bin 
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sudo apt-get update 
sudo apt-get install xscreensaver 


sudo nano /boot/config.txt 





vcgencmd get_config <config> 


vcgencmd get_config arm_freq 


vcgencmd get_config int 


vcgencmd get_config str 









Free up space 

You can save space on your microSD card 
for projects, documents, and code by 
removing some of the programs provided in 
Raspbian by default. You can remove software 
from the command line: 


sudo apt purge mathematica 
sudo apt clean 
sudo apt autoremove 


But it's much better to choose Menu > 
Preferences > Recommended Software. Clear 
the tick next to the unwanted program and 
click OK. 


Kernel update (& rollback) 


If you use the standard Raspbian update/ 
upgrade process, this will automatically 
update the kernel to the latest stable version. 
This is the recommended procedure. However, 
sometimes you may wish to update to the 
latest ‘bleeding edge’ or test kernel. 


sudo rpi-update 


The rpi-update utility will download the 
latest (unstable, testing) kernel version and 
copy all required files onto your system. Note 
that the latest kernel from rpi-update is 

not guaranteed to work correctly! Make sure 
that it doesn’t conflict with your distribution 
packages. It doesn’t provide a way of 
automatically uninstalling the files. 

To revert to the current stock Raspbian 
kernel after trying rpi-update or a custom 
kernel, you need to reinstall both these 
packages, by running: 


sudo apt-get install --reinstall 
raspberrypi-bootloader raspberrypi- 
kernel 
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Change your password 
With the standard install of Raspbian, the 
default username is pi and the password is 
raspberry. If you haven’t at least changed this 
password, anyone can log into your Raspberry 
Pi! Go to Menu > Preferences > Raspberry Pi 
Configuration. In the System tab, click Change 
Password, enter one, confirm it, and click OK. 

















Keep Raspbian up to date 
From time to time, security 
vulnerabilities are found in software, so 
it’s always best to get the latest versions ona 
regular basis. Ina Terminal, type sudo apt- 
get update to update your package lists, then 
sudo apt-get dist-upgrade to get the latest 
version of the packages on your system. 


Install Fail2ban 


If someone wants to hack into a Raspberry 
Pi, they may try to guess your username 
and password. It will probably take a lot of 
attempts, but this is called ‘brute-forcing’. To 
prevent this, you can install a program called 
Fail2ban. Install using sudo apt install 
fail2ban and a user will be banned for ten 
minutes if they fail login five times. 


Change default SSH port 

If you change the default SSH port, 
anyone trying to connect would need to 
know which port to use. To alter it, sudo nano 
/etc/ssh/sshd_config and change the line 
#Port 22 to read Port 2222 (without the #) or 
another memorable number. Save and exit 
(CTRL+O, ENTER, CTRL+X), then restart SSH 
with sudo service ssh restart. 


Turn off interfaces 

you don't need 

The safest way to stop hackers is to not 
have any network connection, but another way 
of shutting down the system a bit more is to 

eo into Main Menu > Preferences > Raspberry 

Pi Configuration and select the Interfaces tab. 
Make sure everything you don’t need is disabled. 
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sudo apt-get update 
sudo apt-get install fritzing 
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sudo apt-get upgrade 
sudo apt-get install arduino 
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One of the best ways to boost your 

XQ programming skills is to complete 
challenges. If you are looking for some 
programming challenges, then sign up for 
Codewars on your Raspberry Pi. The website 
(codewars.com) has a video game style, and 
you get points and advance through levels by 
completing challenges (kata). We’ve even seen 
the latter being used in job interviews and to 
gain entry to coding boot camps. 





There’s a technique to soldering wires 

= together called the ‘Western Union’ or 
‘Lineman’ splice, and you should learn it if 
you’ re going to solder (magpi.cc/mckKVW). It 
was developed during the introduction of the 
telegraph (hence the name), and the wrapping 
pattern is designed to tighten as the two ends 
pull against each other. 


27 We can’t recommend highly enough 

w putting together a maker kit. This should 
contain a wide range of electronics parts, bits, 
and tools. Find a good components case and 
put in it a selection of resistors, capacitors, 
LEDs, buttons, potentiometers, a piezo buzzer, 
and a breadboard with lots of jumper cables. 
You can pick up kits and parts from most 
Raspberry Pi resellers, or visit the Raspberry 








Pi store in Cambridge. We use a half-size 
breadboard in our diagrams, so if you get that 
type you’ll find it much easier to follow our 
projects: magpi.cc/dXHByV. 


Codewars is a good 
web resource for 
practising and flexing 
your programming 
muscles 





















Learning the 
‘Western Union’ 
splice technique will 
make your soldering 
joints stronger 


Get to know your local second-hand 
(‘thrift’) store. Used objects can bea 
ereat source of inspiration, and upcycling old 
tech with new Raspberry Pi parts is a popular 
pastime. High-profile maker Martin Mander 
has rescued old radios, televisions, and toys. 
Follow him on Twitter (@MartinW Mander) 
for inspirational ideas. 


The best way to get inspiration and help 
for your project is to share it with the 
Raspberry Pi community. In March 2019, 

The MagPi ran #MonthOfMaking on Twitter, to 
encourage readers to share projects with one 
another. But don’t wait till next year — share 
your project on our forum (magpi.cc/forum), 
Facebook (magpi.cc/facebook), or Twitter 
(@TheMagPi). The more other readers see your 
project, the more likely you’ 11 be to finish it. 





Elementi4 has two collections of Tips for 
Makers packed with interesting ideas. 
Sign up with the Element14 website to access 
them: magpi.cc/XQaCyC. 
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You'll Need Raspberry Pi has two standard ways of 
connecting to a network: with an Ethernet 
Network cable cable or on-board WiFi (on newer models). 


The Ethernet cable is usually either a Cat5e 
or Cat6 (for fast networks) type, with an RJ45 
connector on each end. One end plugs into a 


Talksidalsimceleinaig 


Talesyaarsimece)alatsveat(eyal 


Pi. Wired connections are generally faster 
than WiFi and will connect as soon as the 
cable is plugged in. Home wireless network 
connections can usually be connected to by 
just selecting the network and typing in a 
password — see magpi.cc/HiDkyk. 


An IP (Internet Protocol) address is a 
number allocated to your Raspberry Pi 
so that other computers know where to find 
it on the network. There are several ways to 
find your Raspberry Pi’s current IP address. 
In a Terminal window, there are a couple of 
oresaubook-veler Miceli mer: DamUny-mam Moeme) Kemereyenbank-vere! 
(which still works) is fieees. There is a 
new shorter command now, ff, which will 
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(elu g mkete)mKomele)\ dal lerele 
files, such as PDFs of 
The MagPI issues 
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router or hub and the other end into Raspberry 























provide similar information. Your local 
IP address will be the number that looks 

something like 192.168.0.34. You can also 
find your IP address by hovering over the 
network icon (top right) of your desktop. 


The terms IPv4 and IPv6 are descriptions 
of the internet protocol and address. 
IPv4 uses 32-bit numbers for the address 
and looks something like: 192.168.1.23. As 
the internet has now grown so large, the 
limited number of available IPv4 addresses 
has become a problem. A new version of 

IP (IPv6), using 128 bits for the IP address, 
has been defined. In July 2017, the final 
definition of the protocol was published, 
although IPv6 has been in use for over 20 
years. An IPv6 address looks something like: 
fe80:94c:38c8:4600:7b33:64bb:baf7:e866. On 
a home network you will normally be using 
IPv4 format addresses, but look out for that 
to change in the future. 


You can do quite a lot with network 
commands in the Terminal. Some 
commands need to be installed first. The 
ping command is there by default. If you type 
Fty4 and then either an IP address or a web 
domain, it will tell you how long it takes to 
send a message to that computer/server and 
then get a reply. Cat is also pre-installed. 
Type 
to see the status of your WiFi connection. 
OMe AGOcRdesudo apt-get install | 


whoisfvemai(stmagrswhoispisaieemeGsreven 
name and you will find the registration 


details of that domain. 





Raspberry Pi has several files where 

it holds details about networking. It’s 
quite useful to know where some of these 
are, aS you may need to change some of the 
information for custom configurations. The 
file /etc/hosts has a list of names that map 
to IP addresses. You could have an entry that 
Says ‘192.168.0.3 myserver’ and that would 
mean that if you typed ‘myserver’ into a web 
browser address bar, the network would try 
to connect to 192.168.0.3. Other useful files 
are /etc/networks, which has network names 
mapped to IP addresses; /etc/protocols, which 
has a list of all the network protocols that can 
be used; and /etc/services, which has a list of 
all the network services available. 


36 If you want to know what’s happening 
N\ 


between your Raspberry Pi and the rest of 
the network, there are a few commands you can 
install. A simple stats command is available 
with sudo apt-get install vnstat. When 
you run this command, it will give you some 
basic data transmission totals. If you want 
some extra tools, you could install iptraf-ng, 
which has a menu of different tools and filters 
to analyse the network traffic. To see some 
real-time data transfer stats, install bmon, 
which shows data quantities per second. 


3 t Although Telnet is a very old networking 


IN 


system (first designed in 1969), it is still 
available and can be installed on Raspberry Pi 
using sudo apt-get install telnet. Telnet 
is a bit like a very early version of websites 
and when this is installed, your Raspberry Pi 
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can connect to any Telnet server. For example, You can use lots 


enter telnet towel.blinkenlights.nl 23 - a 


to see an ASCII version of Star Wars, or try your Raspberry Pi 
network connections; 

telnet mtrek.com 1701 fora Star Trek you can even play 

game. There are lots of Telnet sites still One aime > auc 


: Terminal window! 
out there, some of which can be found at: 


telnet.org/htm/places.htm. 


PiServer is a useful tool for networking 
many Raspberry Pi boards together 
without needing SD cards in them. For info on 
how to set it up, go to magpi.cc/RQDQXx. 


You can download files directly in the 
Terminal with the curl tool. Use curl -0O 
<URL>. See magpi.cc/JrKoTA for more info. 


If you use the Raspberry Pi in a ‘headless’ 
mode (without the Raspbian interface), it 
can be tricky to connect to a wireless network. 
You will need to define a wpa_supplicant.conf 
file for your particular wireless network and 
put this file in the boot folder. See here for 
more information: magpi.cc/RHviuV. 
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Applications in Linux systems, 

such as Raspbian, have three ways 

of communicating with you and other 
applications: standard in (stdin), standard 
out (stdout), and standard error (stderr). 
Output from a command-line application 
arrives on stdout and you can use the pipe 
character ‘|’ to send that output directly into 
another application, like this: 


Here we get a long-form listing of the current 
directory and pipe that output into ‘wc’, a 
counting application. The $l argument means 
‘count the lines’, so we now have a ‘new’ app 
that tells us how many items are in a directory. 
You can chain as many commands as you wish 
to achieve complex tasks. 





Try this: 


The command downloads a cat image — but 
you’re on the Terminal, which can’t show 
graphics. The image arrives as a lot of 
nonsense on stdout. We can use redirection to 
save it as a file like this: 





The ‘>’ operator tells Raspbian to put 
everything arriving on stdout into the file 
instead of your screen. You can also use ‘>>’ 
which appends to an existing file, or ‘<’ to 
feed the contents of a file into a command. 


You can put multiple commands 
together on a single line so that they 
execute one after the other: 
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command1; 


To only proceed if the previous command 
has succeeded: 








...will create a directory, move into it, and 
open up the nano text editor with a new file, 
myFile.txt. You can save this line somewhere 
for future use or create an alias (see Tip 47). 











Running a command ‘in the background’ 
enables you to issue other commands 
while it works. If you’re using the Desktop, 
the simplest solution is to open another 
Terminal window. Alternatively, to have 

a process run in the background, add an 
ampersand (&) at the end of the command: 


This works well, but any output to stdout and 
stderr will appear on your console screen. To 
avoid this, use ‘nohup’: 


















Now all output is written to nohup.log in 
your current directory. 


Sometimes when a process is generating 
output, you might need to follow what’s 
happening. For example, your web server isn’t 
working quite right, so you can troubleshoot 
the problem by looking at the logs. To show 
the contents of any file on-screen: 





However, if the log file is huge, you’ struggle 
to cope. To show the file in ‘pages’: 


less text.txt 
To just see the last few lines: 
tail text.txt 


Best of all, to ‘follow’ the log file as it grows: 






tail -f text.txt 


A miscellany of shortcuts 
Tilde — The tilde character ‘~’ always refers 
to your home directory in paths. Socd ~ 
always takes you home (as does ed on its own). 


TAB autocompletion - Whenever possible, 
Raspbian will attempt to complete the 
command name you are typing. Try typing whoa 
followed by TAB. It will expand to whoami. This 
also works for paths. 


History - Forgotten that command? Your 
Raspberry Pi is keeping track. Pressing the up 
arrow key repeatedly goes through previous 
commands. Or run history to get a full list. 


!! - Two exclamation marks means ‘the 
previous command’. Forgot to use sudo? Don’t 
type the command again, just enter sudo !!. 

























Using aliases 

If there’s a long command you’re going 
to be using a lot, create an alias for it. 
Aliases are kept in a hidden file (non-existent 
by default) called .bash_aliases, in the home 
directory. To create or view contents: 


nano ~/.bash_aliases 


For each alias you want to create, enter a line 
following this pattern: 


alias howmany="1s -1 | wc -1" 
Now you can run howmany for that command. 


It's got stuck! 

Stuck with a crashed program on your 
screen? To gain access back to the 
prompt, try CTRL+C to stop the process, or 


killall <commandname>. You can use ps ax to 
show a list of running processes. Still there 
Try sudo killall <commandname>. As a last 
resort, use sudo kill -9 <processid> (get 
the process ID from ps ax). 





CTRL+Z to put it in the background. Now enter 
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Some command- 
line applications 
take on a basic 
graphical 
appearance to 
make them easier 
to use. The most 
likely you are to 
see is raspi-config 


Find out more 


Many commands come 


man command 


man man 


summary of options. 


Get in remotely 


ssh raspberrypi.local 
Then, if you get to a prompt: 


sudo shutdown -h now 


Change password for the curr 


Configure options for start-up 

Set up language and regional sett 
Configure connections to peripher 
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with a huge array of ‘arguments’ that 
control behaviour. These are in the form of 
‘switches’ (simple flags) or ‘parameters’ that 
provide additional info such as an input file. 
Most commands have an accompanying ‘man’ 
page (short for manual). To see if a ‘manpage’ 
exists for your command, just enter: 


You can even learn about ‘man’ itself: 


Alternatively, many commands respond to the 
switch --help (or -h for short) to provide a 


We’ve all been there: happily working 
away in Raspberry Pi Desktop and 
something goes awry. Now the screen has 
locked up, your Doom high score is lost, and 
the only option is to unplug your Raspberry 

Pi, which risks data corruption. Well, you 

may be able to get in using SSH, which allows 
you to log into your Raspberry Pi (so long as 
you’ve already enabled SSH on it) from another 
computer and get to the command line: 


...and your Raspberry Pi is rescued. H 
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You'll Need 


> Raspberry Pi 
> microSD card 


>» Keyboard and 
mouse for setup 


>» Network and 
router (Ethernet 
recommended) 
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Samba file server 


Use Samba/CIFS to share a Raspberry Pi directory 


with other computers on ag network 


file server where you can store backups and 
share files from all the other computers on 
your network. 
Samba is the Linux implementation of the SMB/ 
CIFS file-sharing standard used by Windows PCs 
and Apple computers, and widely supported by 


t’s easy to use a Raspberry Pi as aSamba 


media streamers, games consoles, and mobile apps. 


With Samba activated, you can quickly copy files 
from a computer on your network to a Raspberry Pi 


using wireless LAN (or a direct Ethernet connection). 


This tutorial assumes that you’1l use a keyboard, 
mouse, and monitor to set up your file server; 
alternatively, you can enable SSH (magpi.cc/ssh) 
and connect to it remotely from another computer 
on your local network. 


The Samba configuration file is 
located at /etc/samba/smb.conf 


File Edit Tabs Help 
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We also assume you’ re using a 32GB (or smaller) 
microSD card, which provides a reasonable amount 
of storage space without requiring any extra steps 
to make it accessible. However, if you need extra 
storage, it’s possible to mount a large external USB 
drive and create a Samba entry for it. 

Alternatively, if you want to keep things 
compact, you can install Raspbian on microSD 
cards of up to 256GB, although we think it’s 
wiser to install Samba on an external drive and 
use a Smaller microSD to boot Raspbian and 
connect to it. 

We suggest checking non-working microSD 
cards online (magpi.cc/2q97aGO) before you buy, 
to make sure you get one that’s fully compatible 
with the Raspberry Pi. 


pi@raspberrypi: ~/shared 


The [share] section in Samba's 
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Once set up, you can mount your home file 
server on all the other computers on your 
network, and use it as aconvenient place to store 
everything from music files you want to share 
with your housemates, to backups of important 
documents and save-game files you’d like to share 
between computers. 

We recommend using a wired Ethernet 
connection for stability and fast transfer speeds. 
The project will still work if you connect your 
Raspberry Pi via WiFi, although performance will be 
affected, particularly when it comes to copying over 
large files. 


Install Raspbian 

Download the latest version of NOOBS 
(or the latest Raspbian Stretch with Desktop 
image file) and install it to a microSD card. See 
magpi.cc/quickstart if you’re unsure on how to 
set up a Raspberry Pi for the first time. Insert the 
microSD card into your Raspberry Pi and connect 
the keyboard, mouse, and HDMI cable. We suggest 
you connect an Ethernet cable between your 
Raspberry Pi and modem/router (otherwise use the 
wireless LAN icon to connect to a wireless network 
when booted up). Attach the power cable to boot up 
your Raspberry Pi. 


Install Samba 

Samba is available in Raspbian’s standard 
software repositories. We’re going to update our 
repository index, make sure our operating system 





[oe] 


A Activate Samba support in 

Windows 10 and you'll be 
able to access the shared 
directory over a network 








is fully updated, and install Samba using APT. Open 
a Terminal and type: 


sudo apt update 
sudo apt upgrade 
sudo apt install samba samba-common-bin 


Answer Y when prompted. 


Create shared directory 
Now we’re going to create a dedicated 
shared directory in our home directory. 


sudo mkdir /home/pi/shared 
You can put it anywhere, but ours is in the home 


directory (it makes it easier to access without 
adjusting permissions). You’ll be able to access this 
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Samba drive using 
sudo service 
smdb status. 
And you can use 
smbd restart to 
turn the service 
off and on again. 


WV Enter the credentials 
(username and 
password) created 
during the setup 
process to access 
the Samba share 
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directory from other computers on your network. 
Files you drop in here are accessible on other 
computers, and files you drop into the directory 
from other computers will appear on Raspberry Pi. 


Configure Samba 

Now we need to edit Samba’s configuration 
file to make the shared directory visible to other 
computers on the network. First, let’s make a 


backup just in case you want to look at the original. 


sudo cp /etc/samba/smb.conf /etc/samba/ 
smb. conf_backup 


Now let’s edit the Samba configuration file. Enter: 


sudo nano /etc/samba/smb. conf 


The smb.conf file is packed with detailed 
information on the Samba configuration (it’s a 
good idea to read through it all). Scroll to the end 
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of the file and add the configuration code from the 
smb-pi.conf listing. Press CTRL+O to save the file, 
and CTRL+tX to exit nano. 


Looking at the configuration file 

The Samba configuration file uses the 
same format as Windows .ini files, with sections 
surrounded with square brackets. The commands 
are case-insensitive and ignore white space. Let’s 
take a closer look at some of the lines in the file... 


The location of the shared folder: 


path = /home/pi/shared 


Set this to ‘no’ to turn off the service: 


available = yes 


This is the list of users allowed to log in to 
the service: 


valid users = pi 


Whether this share is seen in the list of available 
shares in a net view and in the browse list: 


browsable = yes 


Ensures that users can write to files (the default 
is no): 


writable = yes 


Take a look at the Samba.org documentation for 
more information on all the configuration options 


available in smb.conf (magpi.cc/alEJZY). Test out 
the Samba configuration file with testparm. Enter 
the following: 


testparm 


...and you should see a series of ‘Processing 
section’ tests. At the end it should say ‘Loaded 
services file OK’. If not, head back to the start of 
this step and check you have entered the additional 
setup text correctly. 


Create a password 
Before we start the server, you’1l want to set 
a Samba password. Enter: 


sudo smbpasswd -a pi 


Enter a simple and memorable password for 
testing (you can create a more secure one later by 
rerunning the command at any time). 

Now restart your Samba server: 


sudo service smbd restart 


The Samba service will restart and the shared drive 
will now be available on the network. 


07 Turn on SMB in Windows 

Samba used to be installed by default 
in Windows, but it has recently become an 
optional installation. 

In Windows 10, click on the Search bar and type 
‘Control Panel’. Click on Control Panel in the 
search results. Now click ‘Programs’ and ‘Turn 
Windows features on or off’. Scroll down to find 
‘SMB 1.0/CIFS File Sharing Support’ and click the 
‘+? expand icon to reveal its options. Place a check 
in the box marked ‘SMB 1.0/CIFS Client’. Click 
OK. This will enable Samba client support on your 
Windows 10 PC so it can access your Raspberry Pi. 


Find your Pi on the network 
You’ ll now be able to find your Raspberry Pi 
file server (named RASPBERRYPI by default) from 
any device on your local network. 
Click on the File Explorer icon in Windows and 
choose the Network option in the sidebar. You will 


TUTORIAL 


* ‘ee fem = 


a 
ix 
ie, 
pe 

‘. 
B 
+ 





t 2 © Deopeco Baepiery Pil 2 7 
: aac oN | Sa compete : x 
a toes = 1 co = =, 

Ceaeing 1 ie isan midspoi-siouet to chat 








" 19% complete i) x 
D Geiss 
2 Bosna Sevpet 1 MEL 
| Gorioacs 
D Mahi 
2 Music Paperens Wp ul Teel 
_ @hicordtiies Tine cerning: Calculating. 
—_ berms remadeing 1 GT Me} 
Pictures 
) Public 
Fewer Gietaels 
D pyten gen 
i shares ge Maght- Digital: Tem pat OS Dee Socio I ry 
| Templates ge MagPi-Equbditond pot 
) YVews ee Wig - Etubditiont? po! 
L stare me Proqect lock lest 
Se RSI WAUC i, Prepects_Biatk_ tpi 
ROSE 


0g. Predects_Book wiupol! 








per ei) FT 
1 ities peerlaia ar 17 Ma 


A A file being copied from 
the Windows PC computer 
to the shared directory on 
Raspberry Pi 





ni DOWNLOAD 
smb-pi.conf THE FULL CODE: 


>» Language: ASCII yy) magpi.cc/ryrLvF 


















Q@1. [share] 
002. path = /home/pi/shared 
003. available = yes 
204. valid users = pi 
Q05. read only = no 
006. browsable = yes 
public = yes 






see RASPBERRYPI in the list of devices. Click it 
and the ‘Enter network credentials’ window will 
appear. Enter your username pi and the password 
you created in Step 6. Click ‘Remember my 
credentials’ if you want to save the password, and 
then click OK. 


TopTip @ 


Reboot 
| The File Explorer will now display the shared everything 
directory. You can drag files and folders from 
Windows to the shared folder and they will be If you've set 
copied to your Raspberry Pi. it all up and 


have checked 
everything, try 
restarting your 
Raspberry Pi 
and Windows 


Find the Pi on a Mac 


Samba works across many different devices. computer. 
And it’s perfectly possible to access the shared Sometimes this 
folder from a Mac computer, or even an iOS or helps Windows 


find the drive on 
the network (once 
the shared drive 
appears, we find 
it stable). 


Android device (with the right app). Open a new 
Finder window on a Mac and choose Network in 
the sidebar. Click on ‘raspberrypi’ and ‘shared’ 

to access the directory. As with Windows, you can 
drag files directly to and from Raspberry Pi. Wl 
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Use SSH (Secure Shell) 
with Raspberry P1 


Remotely control your Raspberry Pi from a PC, Linux, or Mac 
computer and transfer files using SSH. By Lucy Hattersley 





Lucy 
Hattersley 





Lucy is the editor 
of The MagPi. 

She likes retro 
gaming, building 
robots, coding, and 
making magazines 
and websites. 


magpi.cc 


You'll Need 


> Raspberry Pi 
> Network router 
> Raspbian OS 


>» Second computer 
(Windows, macOS, 
or Linux) 


encrypted networking technology that 
enables you to manage computers from 
the command line over a network. 

SSH is handy if you want to quickly connect to a 
Raspberry Pi from a terminal window on another 
computer. It’s also ideal for lightweight distro 
installations that don’t have graphical interfaces, 
and projects that don’t have a screen (such as 
robots). It’s especially useful when creating 
Internet of Things (oT) projects, as these may be 
embedded inside other hardware. 

We covered VNC (Virtual Network Computing) 
on page 19 — and in more detail in issue 71 of The 
MagPi, magpi.cc/71 — and Secure Shell offers a 
similar service. But while VNC shares the entire 
desktop, SSH works from the command line. 


C SH (also known as ‘Secure Shell’) is an 






Ba pi@raspberry pi: — 


£ 


Servet! Loc... 


1 
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Leecal site: CAUeers\ueryh' Desktop, 


Filename 

2 files, Total sie: 39,254,781 bytes 
D.. Remote fle Size Pr, Status 
Queved files Failed transfers Successful transfers 


=a SSS SSS eT 


SSH also enables you to share files to, and 
from, a Raspberry Pi using SCP (secure copy) 
on the command line, or SFTP (SSH File 
Transfer Protocol). 

You don’t need to install any software to start 
using Secure Shell. Linux, macOS, and Windows 10 
have the SSH command-line application installed 
by default. 

You’1] need to use the password for your 
Raspberry Pi to log in. For security reasons, 
we strongly recommend changing the default 
password (magpi.cc/tZdxha). 

SSH uses an encrypted network, so it doesn’t 
send your password as plain text. More advanced 
users can control the encryption Keys, using 
ssh-keygen. For now, we’ll look at setting up and 
using Secure Shell. 











FOTR 


Password Part: 


| Quickeonneck 


ay 


rectul 
e/pi' Documents” 
nits 

al = i 
LeeniMents” successful 


Rerote site “home pi 

(ee Becki A | pi a 
P P 

1 Gownleads - 7 cache - 


File... = | Filename Fil... File. Last... | = 
* a + 


7 files and 17 directories, Total size: 10,108 bytes 


2) Queue: empty ow 











A SSH is turned off by default in Raspbian and has to 


be enabled. The easiest way is to use Raspberry Pi 
Configuration Tool 





Activate SSH in Raspbian 

For security reasons, Secure Shell is 
not turned on by default in Raspbian. On your 
Raspberry Pi, choose Menu > Preferences > 
Raspberry Pi Configuration. Click on Interfaces and 
set SSH to Enabled. Click OK. You don’t need to 
restart your Raspberry Pi, and SSH will be enabled 
whenever you use that installation of Raspbian 
from that point on (be sure to have updated your 
password from the default, which is ‘raspberry’). 


Activate SSH Client in Windows 

Linux and macOS both support SSH out-of- 
the-box; skip ahead to Step 3 if you are using one 
of those operating systems. 

Windows 10 supports SSH, but you need to 
activate it. Click on Search and look for ‘Manage 
Optional Features’. Click it in Search to open the 
Settings window. 

Click ‘Add a feature’ and wait for the list of 
Optional Features to load. Scroll down the list to 
Open SSH Client (Beta). Click Install. 


Get your IP address 

Connect your Raspberry Pi to a local network. 
Use wireless LAN, or connect Raspberry Pi directly 
to a router with an Ethernet cable. Open a Terminal 
window and enter the following command: 


hostname 
You should see: 

raspberrypi 
In some circumstances you can use this host name, 
which is handy if you don’t have the IP address, but 


it’s more reliable to use the IP (internet protocol) 
address. Enter this to get your IP address: 


hostname -I 


This will return four numbers separated by dots. 
For instance, ours is: 


192.168.0.41 


Write this number down. You’1] need it shortly. 


Connect via SSH 

Open Command Prompt on a Windows PC, 
ora Terminal window in Linux or macOS. 
Enter this command: 


ssh pi@<IP> 


Replace <IP> with the IP address of your Raspberry 
Pi. In our case, we enter ssh pi@192.168.0.41. 

The first time you do this, you’ ll get a message 
saying that the authenticity can’t be established, 
followed by a long cryptographic hash of letters 
and numbers. It will say, ‘Are you sure you want to 
continue connecting® 

Enter yes and press RETURN. You’ll be asked to 
enter the password for your Raspberry Pi. 


On Raspberry Pi 

You will now see your usual command line 
replaced with pi@raspberrypi: ~S. You are now 
logged in and working on the command line from 
your Raspberry Pi. Enter 1s and you’ | see Desktop, 
Downloads, Documents, and the other unique 
Raspberry Pi folders and files. You can create, edit, 
move, and work with files as if you were using 
Terminal on your Raspberry Pi. 





TUTORIAL 


TopTip @ 


SSH from boot 


You can activate 
SSH when setting 
up Raspbian 

by placing a 

file named ssh, 
without any 
extension, onto 
the boot partition 
of the microSD 
card from another 
computer. When 
Raspberry Pi 
boots, it looks for 
the ssh file. If it 

is found, SSH is 
enabled and the 
file is deleted. The 
content of the file 
does not matter; it 
could contain text, 
or nothing at all. 


Use the hostname 
command in 
Terminal to confirm 
the host name 
‘raspberrypi’, 

and add the -I 

flag to get your 
assigned IP (internet 
protocol) address 
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TopTip @& 


Turn SSH on 
and off 


You can activate 
and start 

SSH from the 
command line on 
your Raspberry Pi: 


sudo systemctl 
enable ssh 
sudo systemctl 
start ssh 


And turn it off 
using: 


sudo systemctl 
stop ssh 

sudo systemctl 
disable ssh 


Visual interfaces 
There are limitations to SSH. A plain 
SSH connection can’t open programs that use a 
eraphical interface, so you should learn to use 
command-line alternatives (such as nano or vim 
instead of Leafpad for text editing). See How to Edit 
Text files on Raspberry Pi (magpi.cc/BNFKeP). 

On Linux computers, you can forward your X 
session over SSH, to allow the use of graphical 
applications, by using the -Y flag: 





ssh -Y pi@<IP> 


Now you are on the command line as before, but 
you have the ability to open up graphical windows. 
For example, typing: 


scratch & 


...will open up Scratch in a graphical window. 

Note that X11 is no longer present on Macs 
with macOS (magpi.cc/AqEvnA), so you have to 
download and install it (xquartz.org) separately to 
access graphical windows over SSH. 


07 Copy files 
It’s not easy to share files using Secure 
Shell from the command line, but it’s possible 
and a handy skill to learn. If you’re still accessing 
Raspberry Pi, enter exit at the command line to 
return to your local shell: 


exit 


With SSH turned on, you can copy files from 
your source computer to Raspberry Pi using 
SCP. We’ve downloaded The MagPi issue 85 
(magpi.cc/85) PDF file to our Downloads folder. 
We’re going to copy it to the MagPi directory on 
our Raspberry Pi. 

Use the scp command followed by the path to the 
source file, and then the destination location. 
The destination is pi@<IP> followed by a colon ‘:’ 
and the path to the destination location. 


scp <source> pi@<IP>:<destination> 


Replace the <source> and <destination> parts with 
the paths to the file and desired destination folder, 
and add your Raspberry Pi’s IP address. 

For instance, copying the PDF file on our 
machine looks like this: 
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A Use SFTP (Secure File Transfer Protocol) in a program 
such as FileZilla to transfer files to and from your 
Raspberry Pi via a graphical interface 


scp Downloads\MagPi85.pdf pi@192.168.0.41:/ 
home/pi/MagPi 


This copies The MagPi issue 85 PDF from the 
Downloads folder on our Windows PC to the MagPi 
directory on Raspberry Pi. 

Notice that the directory path uses backslash (‘\’) 
for Windows source and slash (‘/’) for the Linux 
destination (if you’re using a Mac or Linux machine, 
it’1l be a slash in both source and destination. ) 


Copying files 

If you copy a lot of files back and forth from 
a computer to Raspberry Pi, then it’s a good idea to 
set up SFTP using a dedicated FTP program, such as 
FileZilla (filezilla-project.org). 

Install FileZilla on your computer (it is available 
for Linux, Windows, and macOS). 

Open FileZilla and choose File > Site Manager. 

Now click New Site and you can give the site a 
custom name, such as ‘Raspberry Pi’. 

Change the Protocol to ‘SFTP — SSH File 
Transfer Protocol’. 

Enter ‘raspberrypi’ in the Host field, ‘pi’ in the 
User field, and your Raspberry Pi password in the 
Password field. 

Click Connect and you will connect remotely to 
the Raspberry Pi. You will see all your Raspberry Pi 
files in the right-hand ‘Remote’ side of the display. 
On the left, in the ‘Local Site’ section will be all 
the files on your computer. Double-click directory 
folders in either side to navigate into them, and 
use the ‘..’ folders at the top of each list to navigate 
back up to the parent folder. 

Double-click a file in Local Site to send 
it to the Remote section, and vice versa. 

Follow the FileZilla tutorial if you need more 
euidance (magpi.cc/WovBegn). 


O,. & 


The only guide you 
THE OFFIcqay need to get started 
with Raspberry Pi 


| How to use 
Tm | °° Your new computer 


e Learn how to set up the Raspberry Pi, 
install an operating system, and start using it 










e Follow step-by-step guides to code your 
Own animations and games, using both the 
Scratch and Python languages 


® Create amazing projects by connecting 
electronic components to the Pi’s GPIO pins 





mise 


Pete otiarns 


worldwide delivery 





WOonwrrPesy put 






By using the command line, you are able to work faster and smarter. 
Discover how to get started today... 












' O38 S © Bows 

@. 

a 

ign 

mk - 

+ anew F y 

a, ae 

LF —- 2 
4 

ites = 

pan BD ” 

i é , 
—— 
¥ 






96 BS Get Started with Raspberry Pi 


8 ODE & © Bipeastenn~o Ve % 3 4) [Esis} rane 
ena p@raspberypi: ~/Documens 





raspberrypi 


~/Documents 
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pi@raspberryp1: ls -lah /home/pi/Documents/ 
total 20K 
drwxr-xr-x | i pi 4.0K Dec 15 14: 
drwxr-xr-xX 31 pi pi 4.0K Dec 15 12: 
-rw-r--r-- 1 pl pl O Dec 15 14: 
drwxr-xr-x 11 pl pl 4.0K Nov 25 17: 
drwxr-xr-x 5 pi pl 4.0K Nov 25 1/7: 
drwxr-xr-xX 2 pi pi 4.0K Nov 25 17: 


pi@raspberrypi: i 





a a a 


wo ™] Po = 


Bh R Ww OW 
LO 


on 
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The permission structure 
of a Unix file or directory »& 


file x ” Se 
SY 


gt Wx FW 


directory owner group other 








one Fileaystan | 
© To Desktop © 
Auto Login: Login as user ‘pi 
Network at Boot: ©) Wait for network 





Yory=-T- Sa) | Splash Screen: © Enabled ©) Disabled 
Raspbian to boot 
falco tal-ecolaalutlare| ne ' (©) Enabled © Disabled 
line (instead of the PANS a Tse ae Sas = : =e 
felge\elal(ers|@ ial <-lar=\ex-)) 
from the Raspberry Pi 
Configuration settings 











-a =all including hidden files 
-h = human-readable (makes large file sizes 
ante} n-wa-r-ler-10)(-)) 


Options are case-sensitive. Sols -landls -Lare 
two different things (small ‘1’ is long listing format; 
large ‘L’ is dereference mode). Sometimes options are 
listed out in full. These start with two hyphens and 
have a single hyphen for spaces. This command is the 
sameasls -lah: 


ls -l --all --human-readable 


But it’s more common to see (and use) the single 
letter approach. 


Te Le) 

Sudo stands for ‘substitute user do’, although it’s 
often also called ‘superuser do’. If you have multiple 
users On your system, it can be used to perform 
commands as another user. 

It’s mostly used to get root access to your Linux 
installation. There is an account that controls your 
pi user, called ‘root’. This is an all-powerful account, 
which can change just about anything on your system. 

Your default account can view files in the root of 
the hard drive, but it can’t create or delete files at 
the root. Enter: 


cd / 
touch test.txt 


You’ll see touch: cannot touch ‘test.txt’: Permission 
denied. However, enter: 


sudo touch test.txt 
...and the test.txt file will be created on the root of 
your hard drive. You can see it using1ls -1. 

Now try to delete it: 

rm test.txt 
It will say rm: remove write-protected regular empty 
file ‘test.txt’?” Enter Y and it’ll say rm: cannot 


remove ‘test.txt’: Permission denied. 
You need to use sudo to remove the file: 


sudo rm test.txt 


You can see why sudo is such a powerful tool. Without 
it, you couldn’t install software using apt or apt-get. 


But with it, you can remove or delete vital system 
files. Enter1ls /bin and you’ll see many programs 
(known as ‘binaries’) used by Linux. These include 
the ls command you just used. Accidentally deleting 
these files could make your system unstable. 

So use sudo with care. In Raspbian you don’t need to 
enter the password to use sudo. On many other Linux 
systems, however, you will be asked for the password 
before you can use sudo. 


What's up, man? 

There are lots of ways of getting help inside the 
command line. The first command you should turn 
to isman. This stands for ‘manual’ and gives you 
instructions on Linux commands and tools. Enter: 


man ls 


...and you’ll see the manual for the list command. 
Notice under the SYNOPSIS it says: 


ls [OPTION]... [FILE]... 


This shows you the structure of the command. 

PN Ga etoycyemr-0 1 Mere) env ent-beXebow-bac Doma alcmmere)nnent-valemmeyo lace) en 
argument’ structure, although some arguments have 
more than one [FILE] argument (such as copy, which 
requires a source and destination file). 

Press the space bar to move down the instructions. 
Here you will see a list of all the available options. 
With man, you can get detailed information on just 
about every tool on the command line. You can even 
get a manual for the man command with: 


man man 


If you need a quick reminder on how to use a 
command, try using it with -h or --help as an option: 


touch --help 


...tells you what options are available with the touch 
command. You can use this with many command-line 
tools to get a quick refresher on how they work. 

Moving from a GUI to acomman4d line is a vital skill for 
hackers and coders. Everything on your computer, from 
programs to preferences, is stored in the file system 
somewhere. Learning to use the command line makes 
you a more capable Raspberry Pi user. 

So, the next time you make a file, move a file, or 
delete something, don’t head to the File Manager. 
Open Terminal and perform tasks from the 
command line. Soon it’ll be second nature. H 
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Gone too long, the A+ is back with the 
power of Raspberry Pi 3 behind it 


he last time the Raspberry Pi family had a 

: new A-form-factor design, more compact 
and lightweight than the full-size B and Bt 

ranges, it was Raspberry Pi A+, released four years 
ago. Since then, the family has grown considerably: 


we’ve seen Raspberry Pi 2, 3, Zero, Zero W and WH, 
3B+ and, most recently, Raspberry Pi 4. 


™ Packs the power of Raspberry Pi 
3B+ into the same footprint as 
the original Raspberry Pi A+ 


Launched in November 2018, Raspberry Pi 3A+ 
packs the power of Raspberry Pi 3B+ into the same 
footprint as the original Raspberry Pi A+. Read on 
for the lowdown on what Eben Upton describes as 
“the best product we can make.” 


UK suppliers: 


2 :pinut PIMORONI 
The Pi Hut Pimoroni 
magpi.cc/zVTpyC magpi.cc/LhuKdS 
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For a complete list of 
2 resellers globally where the 
new Raspberry Pi 3 Model 


CPC RS Components A+ can be purchased, 
please see 
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Veet Raspberry Pi 3A+ 


This mini marvel squeezes a lot into its compact footprint 








SoC: 
Broadcom 
BCM2837Bo 
quad-core A54 
(ARMVv8) 64-bit 
@ 1.4GHz 


V Full-size display (DSI) and 
camera (CSI) ports make 
connecting peripherals a snap 


GPU: 


Broadcom 
VideoCore IV 





NETWORKING: 


2.4GHz and 5GHz A The radio, originally developed 
802.11b/g/n/ac for 3B+, makes Raspberry Pi 
wireless LAN 3A+ the first A-model to feature 
on-board networking 


RAM: 
512MB LPDDR2 
SDRAM 





BLUETOOTH: 
Bluetooth 4.2, 
Bluetooth Low 
Energy (BLE) 


4 Raspberry Pi 3A* benefits 
from the same clever 
power management chip 
(PMIC) as 3B+ 


GPIO: 
40-pin GPIO 
header, 
populated 





STORAGE: 


microSD 


rors: =| «= QuickStart guide 


HDMI, 3.5mm 
analogue audio- 
video jack, 

1x USB 2.0, Raspberry Pi 3A+ is directly compatible with 3B+ 
enlanreN and all other Raspberry Pi models. If you’ve already 
Display Serial got a power supply and microSD card with a new | | 
Interface (DSI) version or Raspbian installed, you're ready to go. A ac Sea ee 

If 3A+ is your first Raspberry Pi, check out pages both full-size HDMI and 
6-13, or see our online QuickStart guide to get up poner ume Vice euiee 
and running fast. 


magpi.cc/quickstart 





DIMENSIONS: 
67x56x11.5mm 
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< Raspberry 3A+ has the 
same 1.4GHz system-on- 
chip (SoC) as 3B+, with no 
loss of performance 


» The biggest change from 
Raspberry Pi 3Bt: the 
reduction from four to one 
USB 2.0 ports 
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Benchmarking 


Raspberry Pi 3A+ 


or projects where a full- 
r size Raspberry Pi is simply 
too bulky, there hasn’t 
been much choice: aside from 
the Compute Module 3, which 
is targeted at industrial users, 
the choices were the four-year- 
old Pi A+ or ultra-compact Pi 
Zero family — and in either 
case it meant a dramatic drop 
in performance. 
Raspberry Pi 3A+ comes 
with the promise of full- 
size performance in a small, 


lightweight, and less power- 
hungry package, but the only 
way to see if that is true or not 
is to put it through its paces ina 
range of benchmarks. 


Spec comparison 

At its heart, Raspberry Pi 3A+ is 

a cut-down version of 3B+. It has 
the same Broadcom BCM2837Bo 
system-on-chip (SoC) roughly in 
the centre of the board, hidden 
under a metal heat-spreader, 


Small but mighty, the reduction 
in size doesnt mean Raspberry 
Pi 3A+ loses any performance 
compared to 3B+ 


which runs at the same 1.4GHz 
frequency. While 512MB of RAM 
is less than the 1GB of a 3B+, the 
smaller Raspberry Pi 3A+ can 
certainly hold its own. 

Looking back at the original 
Raspberry Pi A+, it’s hard to 
imagine they’re from the same 
family: from a single-core 
32-bit 7OOMHz processor and 
no networking to a quad-core 
64-bit 1.4GHz processor with 
built-in wireless LAN and 
Bluetooth. What an upgrade! 


Python GPIO 


Higher is better O 
Designed to highlight a real- 
world bottleneck, the Python 
GPIO benchmark switches a 
single pin on and off while a 
frequency counter measures 

how quickly the pin is toggled. 
The faster the processor, the 
faster the pin can be toggled 
before the processor hits its limit. 


SysBench CPU 


Lower is better 





Focusing on the central processor's 
performance, the SysBench CPU 
benchmark tests how quickly a 
Raspberry Pi can perform prime 
number calculations. For Raspberry 
Pi models with quad-core 
processors, the test is run twice: 
once with a single thread using only 
one of the cores, and again with 


FREQUENCY (kHz) 


62.32 











58.55 
43.07 42.63 a4 42.62 
ModelA  ModelB Zero ZeroW  ModelA+ Model B+ Pj 2 P| 3 P| 3B+ Pi 3At 
343.06 ee WN SINGLE-THREADED (SECS) 
336.91 337.02 
"MULTI-THREADED (SECS) 
218.53 
139.22 
119.22 119.23 
a 
ModelA  ModelB Zero ZeroW + ModelA+ Model B+ Pi} 3 P| 3B+ Pi 3At 


four threads using all four cores. 
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SysBench 
Memory Throughput 
Higher is better 





Processor performance is only 

part of the puzzle regarding 

overall system performance: in the 
SysBench Memory Throughput test, 
measurements show how quickly 

a Raspberry Pi can read and write 
to the random-access memory 
(RAM) in 1kKB chunks, reported in 
megabytes per second (MBps). 


Power Draw 
Lower is better 





More performance typically means 
more power used. Here, each 
Raspberry Pi is connected to an HDMI 
display, wireless keyboard, and, where 
applicable, a WiFi or wired Ethernet 
network before two measurements 
are taken: power used while Raspberry 
Pi is sat idle at the desktop, and again 


while running a CPU-heavy application. 


© 


Thermal 
Performance 
Cooler is better 


I 
I 

I 

I 

I 

I 
Raspberry Pi 3B+ benefited 
from a change to the way ' 
the system-on-chip (SoC) is I 
attached to the circuit board, 
allowing it to better dissipate \ 
heat. With Raspberry Pi 3A+ I 
having a smaller board, 
this test captures thermal I 
images under heavy CPU 
load to show how well the 
I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 

I 


two designs cope. 
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axe READS (MBps) 856.48 


719.76 


" 4kB WRITES (MBps) 


638.27 


425.87 











147.27 139.01 
Meuse 118.14 
105.65 
~ on 
ModelA Model B Zero ZeroW  ModelAt+ Model B+ Pj 2 Pi 3A+ 
BB PowER DRAW LOAD (W/) 
"POWER DRAW IDLE (\W) 4.108 
3.672 
2.601 
2.295 
1.428 
1.02 1.071 
0.714 0.714 MABE 
ModelA Model B Zero ZeroW  ModelAt+ Model B+ Pj 2 Pi 3B+ Pi 3A+ 
Size & Weight O 
Lower is better 
The biggest difference between Raspberry 
Pi 3B+ and 3A+ is their respective sizes. Here, 
the footprint of each model is measured 
from its widest points - to include the size of 
the ports which sit proud of the board - and 
its weight measured, both important aspects 
for embedded and robotics applications. 
"FOOTPRINT (mm?) 
WE weicut «) 
ic ic 5083 5083 5083 5083 50 
39 
3930 3930 
30 29 
2074 +=. 2074 2 
ModelA Model B Zero ZeroW  ModelAt+ Model B+ Pj 2 Pls Pi 3B+ Pi 3A+ 
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Eben Upton anc 
Roger Thornton on 
Raspberry Pi 3 At “VY wesc sn: 


we’ re dealing with a bunch of subsystems,” Eben 
Upton, co-founder of the Raspberry Pi Foundation, 
explains of the development process that has 


Eben and Roger talk about Raspberry Pi 3 At+'s delivered Raspberry Pi 3 Model A+. “Some subset 


ee of the trains will arrive at the station, and when 
INSpIration and launch timing enough of them arrive then we’ve got a new 

product we can make. We don’t have a big team of 
FN RR TS EE EES ar Tara Tse : marketing guys who make PowerPoints about our 
roadmap. It’s much more coffee-table-oriented 
than that.” 


e describe our product design 





Simplifying certification 


Bringing back A+ 

“The A+ form factor was always a good form 

factor,” says Roger Thornton, Principal Hardware 

Engineer. “A lot of people have asked us for an At 

again, and we were able to make that, so we did.” 
With both Raspberry Pi 2 and 3 having 

launched exclusively in larger B-variant form 


“What's the cost to do a certification 
Campaign, Eben asks. “Couple of 
hundred thousand?” 

“For a five-gig one, yeah, it’s about 
250... 300000," answers Roger - the cost 
of clearing a radio-containing product 





like the Raspberry Pi 3 for general sale. V As with any Raspberry Pi, factors, the A+ has been absent from the line-up 
Raspberry Pi 3B+ moved to a modular oo Mangoes (e-Sepin for a full two generations. “It was skipped for 
testing before it’s released ; a 
radio certification, so the existing to the public Raspberry Pi 2 because it simply wasn’t around 


compliance work remains largely valid 
for 3A+. “A lot of the work wed done to 
modularise the board meant that we 
could copy over pretty much all of our 
compliance work,” Roger explains, “so 
thankfully this product's been just a bit 
of paperwork. There's definitely been an 
improvement in time-to-market." 
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FEATURE 


“if we have an 
opportunity to bring 
our best tech down 
a bit, then we do,” 
explains Eben Upton 


I “A lot of people have 
asked us for an A+ 
again, and we were 
able to make that,” 
says Roger Thornton 
of the launch 


Filling a hole 
“There’s a massive performance gulf between the 
3B+ and Zero,” explains Eben. “3A+ represents us 
bringing our best technology to the lowest possible 
price point. We can’t bring this technology down 
to the Zero price point, at the moment, but we can 
bring it down a bit. 

“We don’t just like to sit there at $35 feeling 
pleased with ourselves. If we have an opportunity 


for long enough,” recalls Eben. “It normally takes 
six to nine months for us to get our feet under 
ourselves, and by that time it was very clear that 
the 3B was imminent.” 

“The Zero W happened the year after the 3B,” 
Roger adds, “and to some extent addressed the gap 
that an A+ might have occupied.” 

The Zero family isn’t a complete replacement for 
the A+, though, as the launch of Raspberry Pi 3B+ 


hammered home. 










Miniature size, 
full performance 


“We're confident that the performance you saw 
on a 3B+ youll be able to get on a 3A,” says 
Roger. “There's no reduction because of the 
board size change; you should still be able to 
run the processor at the same speed. We have 
had to reduce the memory to hit the price point 
were after, but it still runs nicely.” 

“When we launched the original At, we 
launched it with half the RAM of the original B+,” 
Eben adds. “At the time that meant 256MB; now 
halving the RAM still leaves you with half a gig, 
which is kind of fun.” 


—_— eee le 


to bring our best tech down a bit, then we do. I 


™ This is us bringing our best 
technology to the lowest 
possible price point 


mean, this is the best product we can make. We 
don’t know how to make anything better at the 
moment. It’s lovely, actually. We like to make 
physically beautiful objects. They sometimes cost a 
bit of money to make, or cost a bit of blood, I think, 
and this... | mean, for me, once we knew we could 
make it, I think we kind of had to. 

“There may be another motivation for doing 
it: it’s kind of tidying up ‘classic’ Raspberry Pi,” 
Eben admits. With their attention turning to 
Raspberry Pi 4 — since launched in June 2019 — the 
hardware design team were starting the research 
phase of figuring out what they might do next. 
“Tying up loose ends is an important part of that, 
and the lack of an A+ form-factor product is a 
loose end,” says Eben. 1! 
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Raspberry Pi Regulatory compliance and safety 
information 

Product name: Raspberry Pi 3 Model A+/B+ 
IMPORTANT: PLEASE RETAIN THIS 
INFORMATION FOR FUTURE REFERENCE. 


Warnings 

* Any external power supply used with the 
Raspberry Pi shall comply with relevant 
regulations and standards applicable in the 
country of intended use. The power supply 
should provide 5V DC and a minimum rated 
current of 2.5A. 


Instructions for safe use 

+ This product should not be overclocked. 

* Donot expose this product to water or 
moisture, and do not place it on a conductive 
surface whilst in operation. 

* Donot expose this product to heat from any 
source; it is designed for reliable operation at 
normal room temperatures. 

* Operate this product in a well-ventilated 
environment, and do not cover it during use. 

* Place this product on a stable, flat, non- 
conductive surface while in use, and do not 
let it contact conductive items. 

* Take care while handling this product to 
avoid mechanical or electrical damage to the 
printed circuit board and connectors. 

* Avoid handling this product while it is 
powered. Only handle by the edges to 
minimize the risk of electrostatic discharge 
damage. 

+ Any peripheral or equipment used with the 
Raspberry Pi should comply with relevant 
standards for the country of use and be 
marked accordingly to ensure that safety and 
performance requirements are met. Such 
equipment includes, but is not limited to, 
keyboards, monitors, and mice. 


For all compliance certificates and numbers, 
please visit www.raspberrypi.org/compliance. 
MiB 


Raspberry Pi 3 {tAt+/ B+Z! 
BEien : BARBIES ARERESE. 
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CeStina 


Raspberry Pi 3 Model At+/ B+ 
DULEZITE: TUTO INFORMACI SI PONECHTE 
PRO POUZIT/ V BUDOUCNU. 


Varovani 

* Kazdy externi napdjeci zdroj pouzity s 
Raspberry Pi musi splnovat prisluSné 
predpisy a normy platné v zemi urceni. 
Napajeci zdroj by mél poskytovat 
stejnosmérné napéti 5V a minimalni 
jmenovity proud 2,5A. 

Pokyny pro bezpeéné pouzivani 

* Tento vyrobek by nemél byt pretaktovan. 

+ Vyrobek nevystavujte vode ani vihkosti a za 
provozu ho neumistujte na vodivy povrch. 

* Vyrobek nevystavujte teplu z jakéhokoli 
zdroje; je navrzen pro spolehlivy provoz pri 
normalnich pokojovych teplotach. 

+ Vyrobek pouZzivejte v dobre vétraném 
prostredi a za provozu ho neprikryvejte. 

+ Vyrobek pri pouzivani ponechte na stabilnim, 
plochém a nevodivém povrchu a zabrante 
jeho dotyku s vodivymi predmeéty. 

+ Pfi manipulaci s vyrobkem dbejte na to, 
abyste zabranili mechanickému nebo 
elektrickému poSkozeni desky ploSnych 
spoju a konektoru. 

* Vyvarujte se manipulace s vyrobkem, kdyz 
je napajen. K manipulaci pouZzivejte pouze 
okraje, abyste minimalizovali riziko poSkozeni 
elektrostatickym vybojem. 

+ Veskerd periferni a dalsi zarizeni pouzivana 
s Raspberry Pi by méla byt v souladu s 
prisluSnymi normami zemé pouziti a méla 
by byt odpovidajicim zpusobem oznaéena, 
aby se zajistilo, Ze splhuji pozadavky na 
bezpecnost a vykon. 

Vsechna osvédéeni 0 shodé a Cisla najdete na 

www.raspberrypi.org/compliance. 


Dansk 


Raspberry Pi 3 Model At+/ B+ 
VIGTIGT: OPBEVAR DENNE INFORMATION FOR 
FREMTIDIG REFERENCE. 


Advarsler 

* Eksterne stromforsyninger, der anvendes til 
Raspberry Pi skal vaere i overensstemmelse 
med relevante bestemmelser og standarder, 


som er gzeldende i det land, hvor anvendelsen 
er tiltaenkt. Stramforsyningen skal give 5 V 
jeevnstrgm og en nominel stromstyrke pa 
mindst 2,5 A. 

Instruktioner for sikker brug 

* Dette produkt ma ikke overophedes. 

+ Udszaet ikke dette produkt for vand eller fugt, 
og szet det ikke pa en ledende overflade 
under drift. 

* Udsaet ikke dette produkt for varme fra nogen 
kilder; det er designet til palidelig drift ved 
normal stuetemperatur. 

+ Anvend dette produkt i et godt ventileret milja, 
og tildaek det ikke under brug. 

* Anbring dette produkt pa en stabil, flad og 
ikke-ledende overflade under brug, og lad 
det ikke komme i bergring med ledende 
genstande. 

: Veer forsigtig ved handtering af dette 
produkt for at undga mekanisk eller elektrisk 
beskadigelse af printkort og stik. 

+ Undga handtering af dette produkt, mens det 
er taendt. Ma kun handteres ved at holde i 
kanterne for at minimere risikoen for skader 
ved elektrostatisk udladning. 

* Alt perifert udstyr eller udstyr, der anvendes 
til Raspberry Pi skal overholde relevante 
standarder i landet for anvendelse og 
meerkes i overensstemmelse hermed for at 
sikre, at kravene for sikkerhed og ydeevne 
er opfyldt. 

For alle overensstemmelsescertifikater og 

numre, ga pa www.raspberrypi.org/compliance. 


Nederlands 


Raspberry Pi 3 Model A+/ B+ 
BELANGRIJK: BEWAAR DEZE INFORMATIE 
VOOR TOEKOMSTIGE VERWIJZING. 


Waarschuwingen 

* Elke externe voeding die met de Raspberry 
Pi wordt gebruikt, moet voldoen aan de 
relevante voorschriften en normen die van 
toepassing zijn in het land van het beoogde 
gebruik. De voeding moet 5V DC en een 
minimale nominale stroom van 2,5A leveren. 

Instructies voor veilig gebruik 

* Dit product mag niet overklokt worden. 

* Stel dit product niet bloot aan water of vocht 
en plaats het tijdens gebruik niet op een 
geleidend oppervlak. 

* Stel dit product niet bloot aan warmte 
van welke bron dan ook; het is ontworpen 
voor betrouwbare werking bij normale 
kamertemperatuur. 

* Gebruik dit product in een goed geventileerde 
omgeving en dek het niet af tijdens gebruik. 

* Plaats dit product tijdens het gebruik op een 
stabiel, plat, niet-geleidend oppervlak en laat 
het niet in contact komen met geleidende 
items. 

* Wees voorzichtig met het gebruik van dit 
product om mechanische of elektrische 
schade aan de printplaat en connectoren te 
voorkomen. 

* Gebruik dit product niet terwijl het wordt 
gevoed. Alleen aan de randen vasthouden om 
het risico op schade door elektrostatische 
ontlading te minimaliseren. 

* Alle randapparatuur of apparatuur die met de 
Raspberry Pi wordt gebruikt, moet voldoen 
aan de relevante normen voor het land van 
gebruik en dienovereenkomstig worden 
gemarkeerd om ervoor te zorgen dat wordt 
voldaan aan de veiligheids- en prestatie-eisen. 

Ga naar www.raspberrypi.org/compliance. 


Suomi 


Raspberry Pi 3 Malli A+/ B+ 

TARKEAA: SAILYTA NAMA TIEDOT 

MYOHEMMAN KAYTON VARALTA. 

Varoituksia 

* Kaikkien ulkoisen Raspberry Pi -laitteessa 
kaytettyjen virtalahteiden on noudatettava 
kaytt6maassa sovellettavia asiaankuuluvia 
asetuksia ja standardeja. Virtalahteen virran 
on oltava 5V DC minimin nimellisvirran 
ollessa 2,5A. 

Ohjeet turvallista kayttoa varten 

* Tata tuotetta ei saa ylikuormittaa. 

- Aldaltista tata tuotetta vedelle tai kosteudelle, 
alaka aseta sita johtavalle pinnalle sen 
ollessa toiminnassa. 

- Ala altista tata tuotetta mistaan lahteesta 
aiheutuvalle kuumuudelle; se on suunniteltu 
luotettavaa toimintaa varten normaaleissa 
huonelamp6ctiloissa. 

* Kayta tata tuotetta hyvin ilmastoidussa 
lampotilassa, alaka peita sita kayt6n aikana. 

* Aseta tama tuote vakaalle, tasaiselle, ei- 
johtavalle pinnalle sen ollessa kaytossa, alaka 
anna sen koskettaa johtavia kohteita. 

* Noudata varovaisuutta tata tuotetta 
kasiteltaessa mekaanisen tai sahkdisen 
vaurioitumisen estamiseksi painetulle 
piirilevylle ja liittimille. 

* Valta taman tuotteen kasittelya sen ollessa 
kytkettyna virtalahteeseen. Kasittele vain 
reunoista sahkéstaattisen purkautumisen 
vaaran minimoimiseksi. 

+ Kaikkien Raspberry Pi-laitteiden 
kanssa kaytettavien oheislaitteiden ja 
muiden laitteiden on oltava kayttomaan 
asianmukaisten standardien mukaisia, 
ja niiden on oltava merkittyja sen 
varmistamiseksi, etta turvallisuus ja 
suorituskykyvaatimukset taytetaan. 

Lisatietojen saamiseksi kaikista 

vaatimustenmukaisuussertifikaateista 

vieraile verkkosivustolla www.raspberrypi.org/ 

compliance. 


Frangais 


Raspberry Pi 3 Modeéle A+/ B+ 

IMPORTANT: VEUILLEZ CONSERVER CETTE 
INFORMATION POUR VOUS Y REPORTER 
ULTERIEUREMENT. 


Avertissements 

* Toute alimentation électrique externe utilisée 
avec le Raspberry Pi doit étre conforme aux 
réglementations et normes applicables dans 
le pays d'utilisation. Lalimentation électrique 
doit fournir 5 V CC et un courant nominal 
minimum de 2,5 A. 

Consignes pour une utilisation en toute sécurité 

* Ce produit ne doit pas étre utilisé a une 
vitesse supérieure a celle prévue pour son 
usage. 

+ N'exposez pas ce produit a l'eau ou a 
I'humidité et ne le placez pas sur une surface 
conductrice pendant le fonctionnement. 

* N'exposez pas ce produit a la chaleur quelle 
qu'en soit la source; il est congu pour un 
fonctionnement fiable a des températures 
ambiantes normales. 

* Faites fonctionner ce produit dans un 
environnement bien ventilé et ne le couvrez 
pas pendant l'utilisation. 

* Placez ce produit sur une surface stable, 
plane et non conductrice pendant son 
utilisation et ne le laissez pas en contact avec 
des éléments conducteurs. 


Faites attention lors de la manipulation de ce 
produit pour éviter tout dommage mécanique 
ou électrique au niveau de la carte de circuit 
imprimé et des connecteurs. 

Evitez de manipuler ce produit lorsqu'il est 
sous tension. Ne manipulez que par les bords 
afin de minimiser les risques de dommages 
dus aux décharges électrostatiques. 

Tout périphérique ou equipement utilisé 

avec le Raspberry Pi doit étre conforme aux 
normes applicables dans le pays d'utilisation 
et étre marqué en consequence pour garantir 
la sécurité et les performances. 


Pour tous les certificats et numéros de 
conformité, veuillez consulter www.raspberrypi. 
org/compliance 


Deutsch 


Raspberry Pi 3 Modell A+/ B+ 
WICHTIG: BITTE BEWAHREN SIE DIESE 
INFORMATIONEN FUR ZUKUNFTIGE REFERENZ. 


Achtung 


Jedes externe Netzteil, das mit dem 
Raspberry Pi verwendet wird, muss den 
einschlagigen Vorschriften und Normen 
entsprechen, die im Bestimmungsland 
gelten. Die Stromversorgung sollte 5 V 
Gleichstrom und einen minimalen Nennstrom 
von 2,5 A liefern. 


Anweisungen fir die sichere Verwendung 


Dieses Produkt sollte nicht ibertaktet 
werden. 

Setzen Sie dieses Produkt nicht Wasser 
oder Feuchtigkeit aus und stellen Sie es 
wahrend des Betriebs nicht auf eine leitfahige 
Oberflache. 

Setzen Sie dieses Produkt keiner 
Warmequelle aus. Es ist fur einen 
zuverlassigen Betrieb bei normalen 
Raumtemperaturen ausgelegt. 

Betreiben Sie dieses Produkt in einer gut 
beliifteten Umgebung und decken Sie es 
wahrend des Gebrauchs nicht ab. 

Stellen Sie dieses Produkt wahrend des 
Gebrauchs auf eine stabile, flache, nicht 
leitende Oberflache und lassen Sie es nicht 
mit leitfahigen Gegenstanden in Beruhrung 
kommen. 

Seien Sie vorsichtig beim Umgang mit 
diesem Produkt, um mechanische oder 
elektrische Schaden an der Leiterplatte und 
den Anschliissen zu vermeiden. 
Vermeiden Sie die Handhabung dieses 
Produkts wahrend der Stromversorgung. 
Produkt nur an den Randern anfassen, 

um das Risiko von elektrostatischen 
Entladungsschaden zu minimieren. 

Alle Peripheriegerate oder Gerdate, die mit 
dem Raspberry Pi verwendet werden, 
miussen den geltenden Normen fiir 

das jeweilige Land entsprechen und 
entsprechend gekennzeichnet sein, um zu 
gewahrleisten, dass die Sicherheits- und 
Leistungsanforderungen erfullt werden. 


Alle Konformitatszertifikate und -nummern 
finden Sie auf www.raspberrypi.org/compliance. 


Italiano 


Raspberry Pi 3 Model A+/ B+ 
IMPORTANTE: CONSERVARE QUESTE 
INFORMAZIONI PER RIFERIMENTO FUTURO. 


Avvisi 


Tutti gli alimentatori esterni utilizzati con 
il Raspberry Pi devono essere conformi 


alle normative e agli standard pertinenti 
applicabili nel paese di utilizzo previsto. 
Lalimentatore utilizzato dovra fornire 5 V CC e 
una corrente nominale minima di 2,5 A. 


Istruzioni per l’utilizzo in sicurezza 


Questo prodotto non deve essere 
overcloccato. 

Non esporre questo prodotto all’acqua o 
all’umidita e non collocarlo su una superficie 
conduttiva mentre é in funzione. 

Non esporre questo prodotto a fonti di calore. 
Il prodotto é progettato per un funzionamento 
affidabile solo alla normale temperatura 
ambiente. 

Utilizzare questo prodotto in un ambiente ben 
ventilato e non coprirlo durante I'uso. 

Per I'uso, collocare questo prodotto su una 
superficie stabile, piana e non conduttiva. 
Evitare che venga in contatto con oggetti 
conduttivi. 

Durante I’uso o lo spostamento del prodotto 
prestare attenzione ad evitare danni 
meccanici 0 elettrici al circuito stampato e 

ai connettori. 

Evitare di maneggiare questo prodotto 
mentre é alimentato. Afferrare solo dai bordi 
per ridurre al minimo il rischio di danni da 
scariche elettrostatiche. 

Tutte le periferiche e le apparecchiature 
utilizzate con il Raspberry Pi devono essere 
conformi agli standard pertinenti per il 

paese di utilizzo ed essere dotate del relativo 
marchio a garanzia della conformita con i 
requisiti di sicurezza e prestazioni necessari. 


Per informazioni su numeri e certificati di 
conformita, visitare www.raspberrypi.org/ 
compliance. 
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Raspberry Pi 3 Model A+/ B+ 
WAZNE: PROSIMY ZACHOWAC TE 


IN 


FORMACJE NA PRZYSZEOSC. 


Ostrzezenia 


Wszelkie zewnetrzne zrdodta zasilania 
uzywane z Raspberry Pi powinny byé zgodne 
z odpowiednimi przepisami i normami 
obowiazujacymi w kraju przeznaczenia. 
Zasilacz powinien zapewniaé napiecie 5V DC 
i minimalny prad znamionowy 2,5A. 


Instrukcje bezpiecznego uzytkowania 


Ten produkt nie powinien byé przetaktowany. 
Nie nalezy wystawiac tego produktu na 
dziatanie wody ani wilgoci, ani umieszczac¢ go 
na powierzchni przewodzacej podczas pracy. 
Nie nalezy wystawiac tego produktu na 
dziatanie ciepta z jakiegokolwiek zrddta; 
produkt zaprojektowano tak, aby dziatat 
niezawodnie w normalnej temperaturze 
pokojowej. 

Uzywaé w dobrze wentylowanym otoczeniu i 
nie zakrywac¢ podczas uzytkowania. 
Podczas uzytkowania nalezy 

umiesci¢é produkt na stabilnej, ptaskiej, 
nieprzewodzacej powierzchni i nie dopusci¢é 
do kontaktu z przedmiotami przewodzacymi 
prad. 

Nalezy zachowa€é ostroznosé podczas 
obchodzenia sie z produktem, aby unikngé 
mechanicznego lub elektrycznego 
uszkodzenia ptyty z obowodami drukowanymi 
i ztaczy. 

Nie nalezy przenosic produktu, gdy jest 
podtaczony do zasilania. Trzymac wytacznie 
za krawedzie, aby zminimalizowac 

ryzyko uszkodzenia w wyniku wytadowan 
elektrostatycznych. 

Wszelkie urzadzenia peryferyjne lub 

sprzet uzywany z Raspberry Pi powinny 


SAFETY & USER GUIDE 


byé zgodne z odpowiednimi normami 
dla kraju uzytkowania i byé odpowiednio 
oznakowane, aby zapewnic spetnienie 
wymagan bezpieczenstwa i wymogow 
eksploatacyjnych. 


Wszystkie certyfikaty zgodnosci i numery 
mozna znalezc na stronie www.raspberrypi.org/ 
compliance. 


Portugués do Brasil 


Raspberry Pi 3 Modelo A+/ B + 
IMPORTANTE: POR FAVOR, GUARDE ESTAS 
INFORMAGOES PARA REFERENCIA FUTURA. 


Avisos 


Qualquer fonte de alimentagao externa 
usada com o Raspberry Pi deve cumprir os 
regulamentos e normas aplicaveis no pais 
de utilizagao. A fonte de alimentagao deve 
fornecer 5V CC e uma corrente nominal 
minima de 2,5A. 


Instrugdes para O USO Seguro 


Este produto nao deve ser usado em 
overclock. 

Nao exponha este produto a agua ou a 
umidade, e nao o coloque em uma superficie 
condutora durante a operac¢ao. 

Nao exponha este produto ao calor de 
qualquer fonte; Ele é projetado para operagao 
confiavel a temperatura ambiente. 

Opere este produto em um ambiente bem 
ventilado e nao o cubra durante o uso. 
Coloque este produto em uma superficie 
estavel, plana e nado condutora durante o 
uso, e nao deixe que entre em contato com 
dispositivos que conduzem eletricidade. 
Tome cuidado ao manusear este produto 
para evitar danos mecanicos ou elétricos a 
placa de circuito impresso e aos conectores. 
Evite manusear este produto enquanto 
estiver ligado. Somente manuseie pelas 
bordas (laterais) para minimizar o risco de 
dano por descarga eletrostatica. 

Qualquer periférico ou equipamento usado 
com 0 Raspberry Pi deve cumprir os padrdes 
de fabricagao e uso relevantes para o 

pais e assim garantir que os requisitos de 
segurang¢a e desempenho sejam atendidos. 


Para todos os certificados conformidade 
e numeros, visite www.raspberrypi.org/ 
compliance. 


Pycckun 


Raspberry Pi 3 Mogenb At+/ B+ 
BA)KHO: COXPAHUTE STY UHDOPMALIMIO 
AVIA BYAYLIETO UCNO/Ib3OBAHUA. 


BHumauHne! 


JItO60/ BHELUHUM VCTOUHUK NVTaHua, 
Ucnonb3yembin c Raspberry Pi, 40 KeH 
COOTBeETCTBOBaTb COOTBETCTBYIOLLIMM 
HOPMaM U CTaHsapTaMm, NPUMeHAeMbIM B 
CTpaHe npegnonaraemoro UCnoONb3OBaHuA. 
UcTOYHMK NUTaHVA AOMKEH O6eCNeuNBaTb 
5 B NOCTOAHHOPO TOKa WU MUHUMasIbHbIN 
HOMUH@sIbHbIN TOK 2,5 A. 


VHcTpyKuNN no 6es0nacHomy UCnNOsJIbSOBaHUtO 


OTOT NPOAYKT He OKEH VCNOMb3OBAaTbCA 
BONpeKU HOpMaTUMBaM NponsogmutTena. 

He nogBepraute 3TOT NposyKT 
BO3AeNCTBUIO BOsbI WV Bar UW He 
pasmelauTe ero Ha NPOBOAALWEN 
NOBeEpXHOCTU BO Bpema paoorpl. 

He nogBeprante 3TOoT NposyKT 
BO3feNCTBUIO Tenna U3 NHO6Oro UCTOUHNKa; 
OH NpeAHasHayeH ANA HafeKHON pasoTbl 
NPU HOPMasIbHOU KOMHATHOU TemMnepatype. 
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* OKCNNyaTUpyNTe 3STOT NPOAYKT B XOPOLUO 
NpoBeTpuBaemon cpese V He HakpbiBaite 
ero BO BpeMA UCnoNb30BaHuA. 

* [lomecTuTe STOT NPOAYKT Ha yCTOMUNBy!10, 
nNnockyto, HENPOBOAALLYIO NOBEPXHOCTb BO 
Bpema Vcnonb30BaHuA VU He NO3BONANTe 
eMy KOHTAKTUPOBaTb C NPOBOAALMMU 
v3zaenuamy. 

* Co6ntofiaiite OCTOPO>KHOCTb Npu 
O6paLeHun C 3TUM NpOAyKTOM, 

UTOObI N36@KaTb MEXAHNYeCKOrO UN 
9NeKTPUYeCKOrO NOBpexKAeHUA NeyaTHON 
nnatbl VU pasbemMos. 

+ WUs36erante o6paleHna C 3TUM NPOAYKTOM 
BO Bpema ero nutaHua. Ucnonb3synte 
TONbKO Kpaa, YTOObI CBECTU K MAHUMYyMYy 
PUCK NOBPEKAeHNA BNeKTpOCTaTUYeCKOrO 
paspaga. 

+ Jlro60e nepudepuntoe ycTpoucTBoO 
vnu o6opysOBaHnve, Ucnonb3yemoe Cc 
Raspberry Pi, 40KHO COOTBETCTBOBaTb 
COOTBETCTBYIOLUMM CTaHsapTam 
ANA CTpaHb! UCNONb30BaHVA VU ObITb 
COOTBETCTBYIOLLIMM O6pa30M MapKNpoBaHo 
Ana obecneyeHua CobmogeHua Tpe6oBaHnn 
6@30NACHOCTH MU NPOUSBOAMTeNbHOCTH. 

fina Bcex cepTudukaTOB COOTBETCTBUA 

HOMepoB, NoKanyicta, NoceTuTe Www. 

raspberrypi.org/compliance . 


Espanol 


Raspberry Pi 3 Modelo At/ B+ 
IMPORTANTE: POR FAVOR CONSERVE ESTA 
INFORMACION PARA FUTURA REFERENCIA. 


Advertencias 

* Cualquier fuente de alimentaci6n externa 
utilizada con la Raspberry Pi debera cumplir 
con las correspondientes regulaciones y 
normas aplicables en el pais de uso previsto. 
La fuente de alimentacion debe proporcionar 
SV DC y una corriente nominal minima de 
2.5A. 

Instrucciones para un uso seguro 

* Este producto no debe ser usado con una 
frecuencia de reloj superior a la nominal. (No 
se debe overclockear). 

* No exponga este producto al aguao a 
la humedad, y no lo coloque sobre una 
superficie conductora mientras esta en 
funcionamiento. 

* No exponga este producto a ningun tipo 
de fuente de calor; esta disefado para 
un funcionamiento fiable a temperatura 
ambiente normal. 

* —Utilice este producto en un ambiente bien 
ventilado, y no lo cubra durante el uso. 

* Coloque este producto sobre una superficie 
estable, plana y no conductora mientras esté 
en uso, y no permita que entre en contacto 
con elementos conductores. 

* Tenga cuidado al manipular este producto 
para evitar dahos mecanicos o eléctricos 
en la placa de circuito impreso y en los 
conectores. 

* Evite manipular este producto mientras esta 
encendido. Sujételo solo por los bordes para 
minimizar el riesgo de dafos por descargas 
electrostaticas. 

* Cualquier periférico o equipo utilizado con la 
Raspberry Pi debe cumplir con las normas 
aplicables en el pais de uso y debe estar 
marcado en consecuencia para garantizar 
que se cumplen los requisitos de seguridad 
y rendimiento. 

Para obtener todos los certificados de 

conformidad y sus numeros de registro, visite 

www.raspberrypi.org/compliance. 
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Svenska 


Raspberry Pi 3 Modell A+/ B + 
VIKTIGT: BEHALL DENNA INFORMATION FOR 
FRAMTIDA REFERENS. 


Varningar 

: Alla externa stromforsdrjningar som 
anvands med Raspberry Pi maste uppfylla 
alla tillampliga regler och standarder i det 
land dar de anvands. Stromforsorjningen 
maste tillhandahalla 5 VDC och ha en lagsta 
markstrom pa 2,5 A. 

Instruktioner for saker anvandning 

* Produkten bor inte 6verklockas. 

+ Utsatt inte produkten for vatten eller fukt, och 
placera den inte pa en ledande yta medan 
den ar i drift. 

+ Utsatt inte produkten for varme fran nagon 
varmekalla. Den ar utformad for tillf6rlitlig 
drift vid normal rumstemperatur. 

* Anvand produkten i en val ventilerad milj6, 
och tack inte 6ver den vid anvandning. 

* Placera produkten pa en stabil, isolerad yta 
vid anvandning, och lat den inte komma i 
kontakt med ledande foremal. 

* Var forsiktig nar du hanterar produkten for att 
undvika mekaniska eller elektriska skador pa 
kretskortet och kontakterna. 

+ Undvik att hantera produkten med stro6mmen 
pa. Hall den endast i kanterna f6r att undvika 
elektrostatiska urladdningar. 

* Eventuell kringutrustning och utrustning 
som anvands med Raspberry Pi maste 
uppfylla relevanta standarder i det land dar 
den anvands, och den bor markas sa att 
sakerhets- och prestandakraven uppfylls. 

Besok www.raspberrypi.org/compliance, for alla 

certifikat och nummer om 6verensstammelse. 


EU 
Radio Equipment Directive (2014/53/EU) 
Declaration of Conformity (DoC) 


We, Raspberry Pi (Trading) Limited, 30 Station 
Road, Cambridge, CB1 2JH, United Kingdom, 
Declare under our sole responsibility that the 
product: Raspberry Pi 3 Model B+ to which 
this declaration relates is in conformity with 
the essential requirements and other relevant 
requirements of the Radio Equipment Directive 
(2014/53/EU). 


The product is in conformity with the following 
standards and/or other normative documents: 


SAFETY (art 3.1.a): IEC 60950-1: 2005 (2nd 
Edition) and EN 62311: 2008 EMC (art 3.1.b): EN 
301 489-1/ EN 301 489-17 Ver. 3.1.1 (assessed 
in conjunction with ITE standards EN 55032 and 
EN 55024 as Class B equipment) SPECTRUM 
(art 3. 2): EN 300 328 Ver 2.1.1, EN 301 893 
V2.1.0 


In accordance with Article 10.8 of the Radio 
Equipment Directive: The device ‘Raspberry 
Pi 3 Model B+’ operates in compliance with 
harmonised standard EN 300 328 v2.1.1 and 
transceives within the frequency band 2,400 
MHz to 2,483.5 MHz and, as per Clause 4.3.2.2 
for wideband modulation type equipment, 
operates at a maximum e.i.r.p. of 20dBm. 
The device ‘Raspberry Pi 3 Model B+’ also 
operates in compliance with harmonised 
standard EN 301 893 V2.1.1 and transceives 
within the frequency bands 5150-5250MHz, 
5250-5350MHz, and 5470-5725MHz and, as 
per Clause 4.2.3.2 for wideband modulation 


type equipment, operates at a maximum e.i.r.p. 
of 23dBm (5150-5350MHz) and 30dBm (5450- 
5725MHz). 


In accordance with Article 10.10 of the Radio 
Equipment Directive, and as per below list 

of country codes, the operating bands 5150- 
5350Mtz are strictly for indoor usage only. 





The Raspberry Pi complies with the relevant 
provisions of the ROHS Directive for the 
European Union. 


WEEE Directive Statement for the European 
Union 

This marking indicates that this product 

should not be disposed with other household 
wastes throughout the EU. To prevent possible 
harm to the environment or human health 

from uncontrolled waste disposal, recycle it 
responsibly to promote the sustainable reuse of 
material resources. To return your used device, 
please use the return and collection systems 

or contact the retailer where the product was 
purchased. They can take this product for 
environmental safe recycling. Note: A full online 
copy of this Declaration can be found at www. 
raspberrypi.org/compliance/ 


China 
Raspberry Pi 3 Model B+ CMIIT ID: 2018AJ2147 


FCC 


Raspberry Pi 3 Model B+ FCC ID: 2ABCB-RPI3BP 
Model A+ FCC ID:2ABCB-RPI3AP 


This device complies with Part 15 of FCC Rules, 
Operation is Subject to following two conditions: 
(1) This device may not cause harmful 
interference, and (2) This device must accept 
any interference received including interference 
that cause undesired operation. Caution: Any 
changes or modifications to the equipment not 
expressly approved by the party responsible 

for compliance could void user s authority to 
operate the equipment. This equipment has been 
tested and found to comply within the limits 

for a Class B digital device, pursuant to part 15 
of the FCC Rules. These limits are designed to 
provide reasonable protection against harmful 
interference in a residential installation. This 
equipment generates, uses, and can radiate radio 
frequency energy and, if not installed and used 
in accordance with the instructions, may cause 
harmful interference to radio communications. 
However, there is no guarantee that interference 
will not occur in a particular installation. If this 
equipment does cause harmful interference 

to radio or television reception, which can be 
determined by turning the equipment off and 

on, the user is encouraged to try to correct the 
interference by one or more of the following 
measures: * Reorient or relocate the receiving 
antenna * Increase the separation between the 
equipment and receiver 


* Connect the equipment into an outlet on a 
different circuit from that to which the receiver 
is connected + Consult the dealer or an 
experienced radio/TV technician for help. For 
product available in the USA/Canada market, 
only channel 1~11 can be operated and these 
channel assignments deal with only the 2.4GHz 
range This device and its antenna(s) must 

not be co-located or operation in conjunction 

with any other antenna or transmitter except 

in accordance with FCC’s multi-transmitter 

procedures. This device is going to be operated 

in 5.15~5.25GHz frequency range, it is restricted 
in indoor environment only 

IMPORTANT NOTE: FCC Radiation Exposure 

Statement; This appliance and its antenna must 

not be co-located or operation in conjunction 

with any other antenna or transmitter. A 

minimum separation distance of 20cm must be 

maintained between the antenna and the person 
for this appliance to satisfy the RF exposure 
requirements. This raspberry Pi product is 
certified for usage as a Single Module under 

the requirements of 15.212. The integration of 

this module into end products is subject to the 
following requirements: 

USER MANUAL OF THE END PRODUCT: 

In the user's manual of the end of product, the 

end user has to be informed: 

* To keep at least 20cm separation with the 
antenna while this end product is installed 
and operated. 

* That the FCC radio-frequency exposure 
guidelines for an uncontrolled environment 
can be satisfied. 

+ That any changes or modifications not 
expressly approved by the manufacturer 
could void the user's authority to operate this 
equipment. 

* That, if the size of the end product is smaller 
than 8x10cm, then additional FCC part15.19 
statement is required to be available in the 
user's manual; This device complies with 
Part 15 of FCC Rules, Operation is Subject 
to following two conditions: (1) This device 
may not cause harmful interference, and (2) 
This device must accept any interference 
received including interference that cause 
undesired operation. Caution: Any changes 
or modifications to the equipment not 
expressly approved by the party responsible 
for compliance could void user's authority to 
operate the equipment. 


LABEL OF THE END PRODUCT: 

The final end product must be labelled in a 
visible area with the following " Contains TX 

FCC ID: 2ABCB-RPI3A/BP". If the size of the end 
product is larger than 8x10cm, then the following 
FCC part 15.19 statement has to also be 
available on the label: This device complies with 
Part 15 of FCC rules. Operation is subject to the 
following two conditions: (1) this device may not 
cause harmful interference and (2) this device 
must accept any interference received, including 
interference that may cause undesired operation. 


ISED 


Raspberry Pi 3 Model B+ IC: 20953-RPI3P 
Raspberry Pi 3 Model A+ 1C:20953-RPI3A 

This device complies with Industry Canada 
license-exempt RSS standard(s). Operation is 
subject to the following two conditions: (1) this 
device may not cause interference, and (2) this 
device must accept any interference, including 
interference that may cause undesired operation 
of the device. 


Le présent appareil est conforme aux CNR 
d'Industrie Canada applicables aux appareils 
radio exempts de licence. Lexploitation est 
autorisée aux deux conditions suivantes :(1) 
l'appareil ne doit pas produire de brouillage, et 
(2) l'utilisateur de l'appareil doit accepter tout 
brouillage radioélectrique subi, méme si le 
brouillage est susceptible d'en compromettre le 
fonctionnement. 


For product available in the USA/Canada market, 
only channel 1~11 can be operated. Selection of 
other channels is not possible. 

Pour les produits disponibles aux Etats-Unis / 
Canada du marché, seul le canal 1 a 11 peuvent 
étre exploités. Sélection d'autres canaux nest 
pas possible. 


This device and its antenna(s) must not be 
co-located with any other transmitters except 

in accordance with IC multi-transmitter product 
procedures. Referring to the multi-transmitter 
policy, multiple-transmitter(s) and module(s) 
can be operated simultaneously without 
reassessment permissive change. Cet appareil 
et son antenne (s) ne doit pas étre co-localisés 
ou fonctionnement en association avec une 
autre antenne ou transmetteur. This radio 
transmitter has been approved by Industry 
Canada to operate with the antenna types listed 
below with the maximum permissible gain 
indicated. Antenna types not included in this list, 
having a gain greater than the maximum gain 
indicated for that type, are strictly prohibited 

for use with this device.Le présent émetteur 
radio (IC: 20953-RPI3P) a été approuvé par 
Industrie Canada pour fonctionner avec les types 
d'antenne énumeérés ci-dessous et ayant un 
gain admissible maximal d'antenne. Les types 
d'antenne non inclus dans cette liste, ou dont 

le gain est supérieur au gain maximal indiqué, 
sont strictement interdits pour l'exploitation de 
l'émetteur. 


Dynamic Frequency Selection (DFS) for devices 
operating in the bands 5250- 5350 MHz, 
5470-5600 MHz and 5650-5725 MHz. Sélection 
dynamique de fréquences (DFS) pour les 
dispositifs fonctionnant dans les bandes 5250- 
5350 MHz, 5470-5600 MHz et 5650-5725 MHz. 
The device for operation in the band 5150-5250 
MHz is only for indoor use to reduce the potential 
for harmful interference to co-channel mobile 
satellite systems. les dispositifs fonctionnant 
dans la bande 5150-5250 MHz sont réservés 
uniquement pour une utilisation a 'intérieur afin 
de réduire les risques de brouillage préjudiciable 
aux systemes de satellites mobiles utilisant les 
mémes canaux. The maximum antenna gain 
permitted for devices in the bands 5250-5350 
MHz and 5470-5725 MHz shall be such that 

the equipment still complies with the e.i-r.p. 
limit.le gain maximal d’antenne permis pour les 
dispositifs utilisant les bandes 5250-5350 MHz 
et 5470-5725 MHz doit se conformer a la limite 
de p.i.re. 


The maximum antenna gain permitted for 
devices in the band 5725-5850 MHz shall be 
such that the equipment still complies with the 
e.i.r.p. limits specified for point-to-point and non- 
point-to-point operation as appropriate. 

le gain maximal d’antenne permis (pour les 
dispositifs utilisant la bande 5725-5850 MHz) 
doit se conformer a la limite de p.i.r.e. spécifiée 
pour l’exploitation point a point et non point a 
point, selon le cas. For indoor use only. Pour une 
utilisation en intérieur uniquement. 


IMPORTANT NOTE: 

IC Radiation Exposure Statement: 

This equipment complies with IC RSS-102 
radiation exposure limits set forth for an 
uncontrolled environment. This equipment 
should be installed and operated with minimum 
distance 20cm between the radiator & your body. 
Cet équipement est conforme aux limites 
d'exposition aux rayonnements IC établies pour 
un environnement non contrdlé. Cet equipement 
doit étre installé et utilisé avec un minimum 

de 20 cm de distance entre la source de 
rayonnement et votre corps. 


IMPORTANT NOTE: 

This module is intended for OEM integrator. The 
OEM integrator is responsible for the compliance 
to all the rules that apply to the product into 
which this certified RF module is integrated. 
Additional testing and certification may be 
necessary when multiple modules are used. 

Any changes or modifications not expressly 
approved by the manufacturer could void the 
user's authority to operate this equipment. 


USERS MANUAL OF THE END PRODUCT: 

In the user's manual of the end product, the end 
user has to be informed to keep at least 20cm 
separation with the antenna while this end 
product is installed and operated. The end user 
has to be informed that the IC radio-frequency 
exposure guidelines for an uncontrolled 
environment can be satisfied 


The end user has to also be informed that 

any changes or modifications not expressly 
approved by the manufacturer could void the 
user's authority to operate this equipment. 
Operation is subject to the following two 
conditions: (1) this device may not cause harmful 
interference and (2) this device must accept any 
interference received, including interference that 
may cause undesired operation. 


LABEL OF THE END PRODUCT: 

The final end product must be labelled in a 
visible area with the following " Contains IC: 
20953-RPI3P / 20953-RPI3A ".The Host Model 
Number (HMN) must be indicated at any 
location on the exterior of the end product or 
product packaging or product literature which 
shall be available with the end product or online. 


Australia and New Zealand 


Class B Emissions Compliance Statement 
Warning: This is a Class B product. In a domestic 
environment this product may cause radio 
interference in which case the user may be 
required to take adequate measures. 


Brazil 


Este equipamento nao tem direito a protegao 
contra interferéncia prejudicial e nao pode 
causar interferéncia em sistemas devidamente 
autorizados. Este produto esta homologado 
pela Anatel, de acordo com os procedimentos 
regulamentados pela Resolugao n°242/2000 

e atende aos requisitos técnicos aplicados, 
incluindo os limites de exposi¢ao da Taxa 

de Absorcao Especifica referente a campos 
elétricos, magnéticos e eletromagnéticos de 
radiofrequéncia, de acordo com as Resolugdes 
n° 303/2002 e 533/2009. 


Mexico 


La operacion de este equipo esta sujeta a las 
siguientes dos condiciones: (1) es posible que 
este equipo o dispositivo no cause interferencia 
perjudicial y (2) este equipo o dispositivo debe 
aceptar cualquier interferencia, incluyendo la 
que pueda causar su operacion no deseada. 
Este equipo esta disefhado para operar con las 
antenas que enseguida se enlistan y para una 
ganacia maxima de 3.5 dBi. El uso de Antenas 
con este equipo no incluidas en esta lista o que 
tengan una ganancia mayor a 3.5 dBi quedan 
PROHIBIDAS. 


Taiwan 
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Raspberry Pi Zero W 





Raspberry Pi NX — 
Zero W case with 
three covers 


USB and HDMI 
converter cables 
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wTH RASPBERRY PI 


The world’s favourite single-board computer, Raspberry Pi is packed with 
potential: it can be a digital camera, a programmable games machine, 
or even a sensor for the International Space Station. While creating a 
Raspberry Pi project, you’ll learn computing, coding, and electronics. 

It’s fun, and creative, and it’s changing the world. 





> Set up your Raspberry Pi 3A+ for the first time 
> Discover amazing software built for creative learning 
» Learn how to program in Scratch and Python 


» Control electronics: buttons, lights, and sensors 





magpi.cc 


Not to be sold separately 


